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Sett i ng up PiUNIX on a (J 068888 


PCS 

Pfaelzei—Wald-Str. 36 
8888 huenchen V8 


Ihis paper contains a set of recipes how to bring up your 
huhiX system on different hardware configurations. 



Choose the appropriate description: 


four 1 ‘lUNi.X/h is configured for a KL 82 disk and delivered 

o n. .. 


in i n i-f i opp i es 
i.e. for 0068888 - 

l b i/ 4 "j 

-cot '1 b / i 

description no. i 

f l o p p i e s 

tb" J 

no . 2 


four HUNtX is always delivered on tape and configured for... 



i<K 06 / 8 / 188 l’iB 

P U J l t s u J 

descript ion 

no. 3 

8 L 82 



; 

! s 

If MUNiX has already 

being set 

up by PCS > 

choose the 


appropriate description and start with Start liUNiX'. 


f 


October Id V 


i982 









DESCRIPTION NO. 1 


Setting up MUN1X on q QU68000-CUH 1S/1 


Your copy of I'lUNIX is delivered on 12 double sided/ double 
density mini-floppies. You got: 

13 one floppy with standalone programs to set up MUNIX 
23 six floppies with the root filesystem dump 
S3 five floppies with the /usr filesystem dump 

The 14,4 Mbyte Winchester-Disk emulates a RL02 disk. 

MONIX is configured for RL02, unit 0 as the root, swap and 
pipe dev ice. 

O’- physical RL02 unit is divided into two logical halves 
, ' max. 10240 S12 byte blocks each. 


DEC-name 

MUNIX special 

files 

DL0 

/dev/rl0 

/dev/rrl0 


/dev/rl 1 

/dev/rrl1 

DL1 

/dev/rl2 

/dev/rr12 


/dev/rl3 

/dev/rr13 



raw devices 


and so on. 


r10 is the root device. It comprises 8000 blocks. The rest 
of the first logical half of DL0 is reserved for the swap 
area. 

rtl comprises 10240 blocks. 


October 26, 1V82 
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The procedure to set up NUNIX _is Qt f.oJ_lgws: 

0! Power on 

II Bus-reset or init 

The Minitor Cboot PKOM! prompts with: 

. N i n i t o r 

21 Insert the floppy with standalone programs into drive 
B. 


3D Load the root filesystem: 


Enter tsystem messages are underlined!: 


. rx 

7/boot 
7 g0 


Cboot f rom f l oppyD 
tload boot program! 
C st art 3 


start of c 68000 

Boot 

: rxC2>03mkfs [load mkfs from floppy 

and start! 

file system size: 8000 (.root filesystem size! 
file system: rlC0,03 
Exit called 

Boot 

^ rxl2/0!restor 

tape? rxt2>0! 

disk? r U 0 > 0! 
last chance before... 


Cload restor from floppy 
and start! 

tbefore entering this line insert 
root dump floppy no.1 into drive 0! 
troot filesystem from floppies to disk! 
C press ret urn"3 


mount volume _2 tinsert root dump floppy no.2 tdrive 0! 

... and press return! 

... land so on! 

end of tape 


43 For loading the /usr filesystem please repeat steps 1! 
to 3! w(th the following arguments: 

mkfs: file system size = 10240, 

file system = rll0,10240! 

restor: Cinsert the 1. /usr dump floppy! 
tape? rxC2, 0! 
disk? r lie,102403 


October 26, 1V82 
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SJ Start MUNIX: 

Bus-reset or iuit: 

. M i n i t o r 

*. r 1 

•_/ unix 
^g0 

m m m 

Start o* c 680 00 

mm* 

Start MUNIX CV1.3I on 0U68000 


6I MUNIX is now running. 

7D One of the first steps you should do is to check 
installed filesystems by /etc/fsck. 


Good luck with your MUNIX/QU68000 system! 


the 


October 26, 1V82 









DESCRIPTION NO. 2 


Sett i ng up tIUNIX on a UU68000 


Your copy of MUNIX is delivered on 7 double sided/ double 
density floppies. You got: 

ID one floppy with standalone programs to set up MUNIX 
2J three floppies with the root filesystem dump 

33 three floppies with the /usr filesystem dump 

MUNIX is configured for RL02, unit 0 as the root, swap and 
pipe device. 

One physical RL02 unit is divided into two logical halves 
with max. 10240 S12 byte blocks each. 


DEC--name MUNIX special files 


DL0 

/dev/rl0 

/dev/rrl0 


/dev/rl1 

/dev/rrl1 

DL 1 

/dev/rl2 

/dev/rrl2 


/dev/r13 

/dev/rrl3 



raw devices 


and so on. 


rl0 is the root device. It comprises 8000 blocks. The rest 
of the first logical half of DL0 is reserved for the swap 
area. 

r(1 comprises 10240 blocks. 


October 26, 


1V82 
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# 

I he procedure to set up MU NIX _is as f oJJows : 


83 Power on 

13 Bus-reset or init 

The Mtnitor (boot PROIT3 prompts with: 

. M i n i t o r 

23 Insert the floppy with standalone programs into drive 

0 . 

33 Load the root filesystem: 

Enter (system messages are underlined3: 

,rx Cboot from floppy! 

7/boot (load boot program! 

7g0 (start! 



start of c 63000 

Boot 

: rx(2/03mkfs 

file syst em size: 8000 
file sy st em: rl(0/03 
Ex it calle d 
Boot 

± rx(2/03restor 

tope? rx(2/03 

disk? r110/0 3 

last chance before ... 

■ ■ • 

mount vo l ume 2 


end of tape 


(load mkfs from floppy 
and start! 

(root filesystem size! 


(load restor from floppy 
and startj 

(before entering this line insert 
root dump floppy no.1 into drive 03 
(root filesystem from floppies to disk3 
(press "return"3 


(insert root dump floppy no.2 (drive 03 
and press return! 

(and so on! 


43 (-or loading the /usr filesystem please repeat steps *13 
to 33 with the following arguments: 


mkfs: file syst e m s ize = 10240/ 

fil e system = rl(0/102483 

restor: (insert the 1. /usr dump floppy! 
tape? r x(2/0 3 
disk? rl(0/102403 
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SJ Start MUNXX: 

Bus-reset or init: 

■ Hi nitor 

L r l 

^/unix 

m m m 

Start of c 680130 

m m m 

Start MUNIX IU1.33 o»i 0U6BUUU 


6J MUNiX is now running. 

7 J One of the first steps you should do is to check 
installed filesystems by /etc/fsck. 

Good luck with your MUNIX/QU68GGG system! 


the 


October 36 


f VB3 






DESCRIPTION NO. 3 


Sett t ng up MUNIX o n_a 0 1.168888 


Your copy of I’lUNIX is delivered on a 9 track 1688 bpi 
It contains following files: 

0J standalone boot program 

13 standalone mkfs Intake file system3 

2 3 standalone rest or Crest ore dumpsJ 

33 root filesystem dump 

4 J /usr filesystem in tar format 



Your 88 MB Fujitsu emulates two RK87 disks and one RK06. 
I’lUNIX is configured for the first RK07 as root, swap and 
pipe device. The second RK07 is reserved for the /usr 
filesystem. The physical drives cun be divided into several 
logical devices. For further details of the logical organi¬ 
zation of the Fujitsu see FIKC4 3 in I’lUNiX Do l. -I. 


dr 

t ve 

MUNI X 

special files 

f i l esyst ent 
size 

use 

U: 

RK87 

/dev/hkO 

9636 

r o o t, p i p e 



/dev/swap 

8918 

swap 



/dev/hk1 

3S178 

free 

1: 

RK87 

/dev/hk2 

S3/24 

usr 

d s 

RK06 

/dev/hk3 

2/860 

free 



October 2/ 
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Procedure to set up 


MUN1X: 


03 Change the set of EPROMS on the processor board for 
booting from tope lK900.0bb, Min 1.13. 


13 Power on 

21 Bus-reset or init 

The Minitor (.boot PROM3 prompts with: 
. M i n i t o r 


33 Mount the tope. 

Ai Load the root filesystem: 


Enter tsystem messages are underlinedJ: 



_. rt 

./boot 

7g0 

m m m 

start of c 6B0O fcI 

Boot 

t m IB , 13 

file system size: 9636 
file syste m: hkC0>03 
Exit calle d 
Boot 

: t m t. 0,2 3 

cape? t m 10,3 3 
disk? hk10,0 3 

last chance_b efo re ... 

ejid of tape 


Cboot from taped 
tload boot programd 
lst art 3 


lload mkfs from tape 
and startd 

Iroot filesystem sized 


l load restor from tape 
and startd 

Iroot filesystem from tape 
to disk 3 

lpress "ret urn"3 



S3 


Change the set of EPROMS for booting from the Fuiitsu 
disk CR900.0b6, Mm 1.23. 


t 
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6 3 Start MUNIXs 

BLIS-reset or i u i t: 

. ft i n i t o r 

.yunix (.load -from hk is default} 

m m m 

Start of c 6 8008 

■ MM 

Start MUNiX 101.33 on UU68888 


73 NUNiX is now running. 

83 The /usr filesystem is divided into two tar-files. The 
first contents a ‘ in i n i-usr-f i l esyst em' , the second 
additional facilities like computer-aided instruction* 
on-line manuals and support for the Versatec printer. 

After creating a filesystem on the hk2* mount hk2 on 
/'usr. Skip the first five files of the tape, t Five* 
because between the dump-file and the tar-file a very 
small file is created. J Take the root as current 
directory t cd / 3 and finally extract the mini-usr- 
filesystem by typings 

tar xvbf 28 /dev/rmtO 

Extract the second tar-file accordingly. 

93 (jue of the first steps you should do is to check the 
installed filesystems by /etc/fsck. 


Uood luck with your MUN1X/0U68888 system! 


October 27, 1982 







(McSCKlFriON NO. A 


Setting up NUNIX on a OU&8008 


Your copy of MUNiX is delivered on o V track 1680 bpi tape. 
It contains the following files: 


81 

standalone 

boot 

program 


1 J 

st anda t o ne 

m k f s 

t m a k e file 

syst cm J 

2 J 

standalone 

restor [restore 

dumps! 

3 J 

root files 

yst em 

dump 


4 J 

/usr filesystem 

in tar format 


MUNIX is configured for RL82> unit 0 as the root, swap and 
pipe device. 

One physical RL02 unit is divided into two logical halves 
with max. 10240 S12 byte blocks each. 


DtO-name MUNIX special files 


DLU 

DL 1 


/dev/r 10 
/dev/‘r l 1 

/dev/r12 
/dev/r l 3 


/dev/rr l 8 
/dev/rr 1 1 

/dev/rr 12 
/dev/rr 13 

raw devices 


and so on. 


rl0 is the root device. It comprises 8UU0 blocks. The rest 
of the first logical half of DL0 is reserved for th^ swap 

area. 

rll comprises 10248 blocks. 


October 2 7, 1V82 
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The procedure to set up NUNIX _is os f o_l J.ows: 

fe)j Power on 

ID bus-reset or nut 

The Minitor tboot PHUMD prompts with: 

. M i n i t o r 


2J Mount the tope. 


3D Load the root -filesystem: 


Enter Csystem messages are underlined!; 


. rt 

.y'bo ot 
. g8 


C b o o t from tapeD 
tload boot programD 
C st art D 


start, of c 688U8 

Boo i 

i tmlto , 1D 

file system size; 8888 
file syst em: rl(0»0] 
Exit calle d 
boot 

l t m l 8,2 D 

tape? t m 10 ,3 D 
d isk? rlC8 > fc) D 
last chance bef ore... 
end of tap e 


tload mkfs from tape 
and startD 

troot filesystem sizeD 


tload restor from tape 
and startJ 

troot filesystem from 
tape to d t sk D 
t press "return") 


4J Start MlJNlX: 

Bus-reset or init: 

. M t n it or 

i r 1 

. /uh ix 
•_g0 

■ ■ ■ 

StQrt of c 68BBU 

• ■ ■ 

Start MUNIX IV1.3D on 0U68888 


SJ MUNIX ts now running. 


October 27, 1982 
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6J The quantity of the /usr filesystem is more than a 
filesystem on a R182 can take. 

The /usr filesystem is therefore divided into two tar- 
files. The first contents a "mini-usr-filesystem' we 
normally deliver for a configuration with a RL.82. I he 
second contents additional facilities like computer 
aided instruction* on line manuals and support for a 
raster printer/plotier. 

Ue suppose to use only the mini-usr-filesystem and 
extract those parts of the second tar-file you really 
need. 

After creating a filesystem on the rM> mount rH on 
/usr. Skip the first five files of the tape. C Five, 
because between the dump-file and the tar-file a very 
small file is created. J fake the root as current 
directory l cd / 3 and finally extract the mini-usr- 
filesystem by typing: 

tar xvbf 28 /dev/rmtB 

/J One of the first steps you should do is to check the 
installed filesystems by /etc/fsck. 


Good luck with your I1UN1X/QU68888 system! 


October 2? > -1982 
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Munix - Erste Schritte auf dem QU68000 



ABSTRACT 

Im folgenden werden die ersten Schritte beschrieben, die Sie 
machen miissen, umUnix auf Ihrer Anlage zum Laufen zu bringen. 

Minitor-Grundlagen 

Legen Sie alle 3 Schalter am Rechner nach oben und schalten Sie das Netz ein. 
Auf der Konsole muss ein Punkt als Minitor-Prompt erscheinen. Erscheint der 
Punkt auch nach Betatigen der Reset-Taste nicht, iiberpriifen Sie die CPU, den 
Speicher und den Anschluss der Konsole. Mit dem Minitor konnen Sie Pro¬ 
gramme von drei unterschiedlichen Geraten booten, namlich der RX02 Floppy, 
der RL02 Platte und der RK06/07 Platte. Mehr Treiber lassen sich zur Zeit aus 
Platzgriinden im Minitor nicht unterbringen, da ja auch noch Debugging-Hilfen 
Teil des Minitors sind. Sie haben eine Unix-Boot-Floppy bekommen, und 
entweder eine fertig bespielte Platte, oder ein Magnetband. Die folgende 
Beschreibung der Konfigurierung geht davon aus, dass auf Ihrer Platte, dem 
root-device, schon ein root-Filesysu -handen ist. 

- r ersuchen sie erst, Unix von dieser Platte zu laden, indem Sie einfach 

rl <return> oder rO<return>, und dann 
/aunix <return> 

eintippen. Kommt eine Fehlermeldung, kann der Minitor von dieser Platte nicht 

f booten, und Sie miissen von der Floppy booten: 

rx <return> 

/aunix <return> 

Eine Minitor-Version kann auch von Band booten (mit "rt"). Nach /aunix ver- 
geht etwas Zeit, bis Unix geladen ist, dann meldet sich wieder der Minitor mit 
Starten Sie nun Unix mit 

g <return> 

Es muss die Meldung "Start of C 68000" kommen. Anschliessend fiihrt Unix 
einen Dialog mit Ihnen, der dazu dient auf Ihrer Anlage ein erstes Unix zum 
Laufen zu bringen, mit dessen Hilfe o n die eigentliche Generierung erfolgt. 


t 
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Root device 

Zuerst wird nach dem root-device gefragt. Geben sie einen von den 
Geratenamen an (HK steht dabei fur RK06/RK07). Anschliessend wird nach der 
minor device number gefragt, d.h. nach der Nummer des logischen Gerates. 
Diese ist nur manchmal mit der physikalischen unit number identisch. Im 
einzelnen: 

rx Nur KX02 wird unterstutzt. Es sind zwei physikalische Laufwerke vor- 
gesehen. Unit 0 und 2 sind Floppy 0 (linkes Laufwerk), unit 1 und 3 Floppy 
1 (rechts). 0 und 1 sind single density, 2 und 3 sind double density. Die 
Anzahl der Blocke pro Floppy sind 500 (single density, single sided), 1001 ( 
single density, double sided oder double density, single sided) oder 2002 
(double density, double sided). Die Blockanzahl ist wichtig fur das Pro- 
gramm mkfs. 

rk Fur die maximal vier Laufwerke ist physikalische gleich logischer Nummer. 
Die RK05 Platte ist 4872 Blocke gross. 


rl Die RL02-Platte wird logisch in zwei Halften unterteilt. Haben Sie zwei 
RL02-Laufwerke, sind die logischen units 0 und 1 auf der physikalischen 
uni t 0, und 2 und 3 auf unit 1. Die logischen units sind je 10240 Blocke 
gross. 

hk Die minor device numbers der RK06/07 Platten berechnen sich als physical 
unit number * 8 + logical unit number. Die RK06/07 Platten lassen sich 
nach folgender Tabelle in logische units zerlegen: 


unit 

0 . 

1 , 

2 , 

3, 

4, 

5, 

6 , 

7, 


size cyloff 
9636, 0, 
8910, 146, 
8514, 281, 
35178,281, 

0 , 0 , 

0 , 0 , 

27060,0, 
53724,0, 


cyl 0-145,root on rk06/7 
cyl 146-280, swap on rk06/7 
cyl 281-409, rest of rkOS pack 
cyl 281-813, rest of rk07 pack 
spare, for avoiding bad blocks 
spare, for avoiding bad blocks 
cyl 0-409, all of rk06 pack 
cyl 0-813, all of rk07 pack 


Wir haben beispielsweise eine Fujitsu 2312 Platte, 80 Megabyte unforma- 
tiert, die durch einen Emulex SC02 controller als zwei RK07 und eine RK06 
emuliert wird. Diese drei physikalischen units werden bei uns in 5 logische 
units aufgeteilt: 

hkO: minor device 0 = 0 * 8 + 0, 

d.h. die ersten 9636 Blocke der ersten RK07, dient als root-system 
swap: minor device 1 = 0 * 8 + 1, 

d.h. die nachsten 8910 Blocke der ersten RK07, dient als swap device 
hkl: minor device 3 = 0 * 8 + 3, 
d.h. der Rest der ersten RK07 
hk2: minor device 15=1*8 + 7, 
d.h. die ganze zweite RK07 
hk3: minor device 22 = 2 * 8 + 6, 
d.h. die ganze RK06 
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: Strap device 

Nachdem das root-device spezifiziert wurde, wird nach dem swap-device gefragt. 
Wieder muss Platteatyp und minor device number angegeben werden. Weiterhin 
wird nach swplo, der Nummer des ersten Blocks des swap-Bereichs, und nswap, 
der L&nge des swap-Bereichs, gefragt. Bei HK besteht die Moglichkeit, eine 
i eigene logische unit als swap-device anzugeben. Bei den anderen Platten muss 

• eine logische unit aufgeteilt werden, so dass teilweise ein Filesystem und ein 

• swap-Bereich auf der Platte untergebracht werden. Beispiel: Ich habe zwei 
RK05, von denen die unit 0 eine Wechselplatte und die unit 1 eine Festplatte ist. 
Ich mochte root und swap auf rkl legen. Der swap-Bereich muss mindestens 
1000 Blocke gross sein, Ich werde dann beim Dialog fur root- und swap-device 
beide Male rk und 1 eingeben, bei swplo 3500 und bei nswap 1372 (4872 - 3500). 
Damit kann ich auf rkl mit mkfs ein filesystem der Lange 3500 einrichten, an 

:das anschliessend der swap-Bereich mit Lange 1372 folgt. Wenn ich ver- 
isehentlich (alles schon passiert) auf rkl ein Filesystem der Lange 4072 ein- 
:richte, werden mir, wenn das System zu swappen anfangt, alle Blocke grosser 
als 3500 iiberschrieben. 


; DMA-Extension-Register 

Die nachste Frage bezieht sich auf die DMA-Extension-Register (DER). Wenn auf 
• der Rvickwand Ihres Rechners noch keine DER-Verdrahtung ist, muss immer 0 
angegeben werden. Die DER-Verdrahtung ordnet jedem Gerat ein DER zu. Das 
igeschieht durch zwei Anzapfungen der Daisychain. Die Daisychain verbindet 
den Ausgang BSACKO einer Karte mit dem Eingang BSACK1 der nachfolgenden 
Karte. Wenn der Prozessor nicht Bus-Master ist, aktiviert er sein BSACKO. Jede 
Karte, die nicht Busmaster ist, gibt BSACK1 an BSACKO weiter. Der Busmaster 
hingegen halt BSACKO auf 0. Bus-Master ist also die Karte, fur die BSACKI = 1 
und BSACKO = 0 ist. Mit den zwei Anzapfungen der Daisy-chain kdnnen die Werte 
00, 10 oder 11 gewonnen werden, je nachdem ob eine Karte Bus-Master ist, die 
vor dem ersten Anzapf, zwischen erstem und zweitem, oder nach dem zweiten 
Anzapf liegt. 1m Beispiel 


[cpu] -* [ 1511 ! -» !RLj ♦1-» ]TM] -» jVPi -»]-*-* [mc -> 1 ME^T -» |MEM| 


wird so dem Gerat RL das DER 0, TM und VP das DER 2 und RX und HK das DER 3 
zugeordnet. Fur Karten, die nicht Bus-Master werden konnen, wie DLV11 oder 
Speicher, ist die Stellung in der Daisy-chain beliebig. 

Die Reihenfolge der Karten im Q-Bus bestimmt ausserdem die Hardware- 
f Prioritat. Bei der Plazierung der Karten sollte man von folgenden Richtlinien 
‘ausgehen: 

'a) Terminals nach vorne. 

’b) Gerate mit 22-bit DMA-controller auf DER 0. Wenn solche Gerate vorhanden 
sind, dann nur diese auf DER 0. 

c) Ansonsten DMA-Gerate gleichmassig auf 0 (wenn ohne 22bit DMA), 2 und 3 
verteilen. 
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d) Liicken mit Speicherkarten fiillen. Wenn spatere Erweiterung, Speicher 
-nach hinten und neues Gerat in die Lixcke. 


Non-Standard Gerate 

Die letzten zwei Fragen beruhen auf Erfahrungen, die wir mit Geraten gesam- 
melt haben. die sich nicht an die Q-Bus Spezifikationen halten. So kann es sein, 
dass ein Gerat eine Q-Bus-Addresse als in der 10-Page liegend ansieht, wenn die 
Addressbits 15, 16 und 17 = 1 sind, obwohl das Signal BBS7 nicht aktiv ist. Das 
fuhrt dazu, dass ein Ansprechen der oberen 16 kbyte jedes 256kbyte- 
Speicherbereichs dieses Gerat manchmal Amok laufen lasst. Ein anderer Fehler 
ist, dass ein Gerat zu lange den Bus blockiert, indem es z.B. 255 Worte in einem 
Schub iibertragt. Andere Gerate, die sich an die Spezifikation halten, konnen 
dann Daten verlieren oder Fehler produzieren. Wenn Sie die Frage, die sich auf 
den ersten Fehler bezieht, bejahen, lasst das System jeweils die oberen 16kb 
frei. Bejahen Sie die zweite Frage, wird dafiir gesorgt, dass nur jeweils ein DMA- 
Gerat zur Zeit aktiv sein kann (Effizienzverlustl). 


Hochfahren 

Nach der letzten Frage wird Unix im single-user-mode hochgefahren. Auf der 
Konsole erscheint ein als prompt. Tippen Sie nun das Datum ein (siehe Date 
1/i). Gehen Sie nach /etc (cd /etc) und beschauen sie sich (cat) die Dateien rc 
und ttys, rc ist ein Shell-File, das jedesmal beim Ubergang vom single-user- 
mode zum multi-user-mode ausgefilhrt wird. In ttys muss Ihre Terminal- 
Konfiguration erstellt werden. Das erste Zeichen der Zeile muss 0 oder 1 sein, je 
nachdem, ob fur dieses Terminal keine oder eine Shell initiiert wird. Das zweite 
Zeichen gibt die Art des Terminals an (z.B. o ftar Perkin Elmer Owl, t fur Tand- 
berg TDV2215, v ftar vtlOO, p fur Siemens PTBO). Ist Ihr Terminal keins von 
diesen, wird lediglich die Clear-screen-Sequenz vor dem login nicht richtig 
funktionieren. Beachten Sie auch die Dateien passwd, fstab, ttytype und 
termcap. Die Beschreibung dieser Dateien finden Sie in 1/5. Gehen Sie nun in 
das directory /dev. Loschen Sie die special files, die Sie nicht benotigen. 
Fahren Sie nun in den Multi-user-mode hoch, indem Sie Ctrl-Z drvicken. An den 
eingeschalteten und in ttys generierten Terminals muss "login” erscheinen. 


Terminal-Konventionen 

Anders als in der Unix-Dokumentation beschrieben, konnen Sie das zuletzt 
eingegebene Zeichen mit BS oder DEL loschen (anstatt §), und die ganze Zeile 
mit Ctrl-X (anstatt @). Das EOT-Zeichen ist nicht Ctrl-D, sondern Ctrl-Z. Zum 
Unterbrechen dienen Ctrl-C (SIGINTR) und Ctrl-Y (S1GQUIT). Diese Konventionen 
stammen von VAX-VMS. 


Editoren 

An Zeileneditoren laufen natiirlich ed und sed. An Biidschirmeditoren gibt es 
vorerst ped (von uns selbst), und vi (von Berkeley). Die Biidschirmeditoren 
passen sich unterschiedlichen Terminals an. In /etc/termcap soil eine Liste der 
an Ihrer Installation vorhandenen Terminalarten stehen Erzeugen Sie 
/etc/termcap durch Abmagerung von /etc/termcap src. Merken Sie sich den 
Kurznamen Ihres Terminals (z.B. pv fur das von PCS gelieferte vtlOO), und 
tragen Sie in /etc/ttytype eine Zeile fur dieses Terminal ein, z.B. "pv ttyi". 
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* 

Nach erneutem Einloggen muss die Shell-variable TERM gleich dem Kurznamen 
sein. 

Terminal-Interface 

Obwohl der QU68000 erheblich schneller als eine LSI ist, kann es passieren, dass 
manchmal bei hohen Baud-Raten am DLV11 Zeichen geschluckt werden. Das ist 
besonders bei den Funktionstasten w&hrend des Editierens festzustellen, bei 
denen oft drei Zeichen hintereinander mit voller Geschwindigkeit zum Rechner 
geschickt werden. Um den EfTekt so klein wie moglich zu halten, wird empfohlen, 
die DLVll-Karten in der Daisy-chain ganz nach vorne zu stecken. Wenn zu 
h&ufig Zeichen verlorengehen, muss die Baudrate herabgesetzt werden. Termi¬ 
nals, bei denen die Cursortasten nur 1 Zeichen abschicken, sind besonders 
guns tig. 

Leider hat das DLV11 keine interne Zeichenpufferung, wohl aber das DZil und 
das DH11, die es auf dem Markt fur 4, 8 und 16 Kanale gibt. Ausserdem bieten 

• diese Multiplexer eine Modemsteuerung. Dadurch wird beim Ausschalten des 
.’erminals das Signal SIGHUP erzeugt, und beim Einschalten automatisch login 
gemacht. Nur mit DZ11 oder DH11 funktioniert der packet driver pk und damit 
uucp und uux. Diese Multiplexer sind aber leider ziemlich teuer. 


Drucker 

1m Kern ist ein Standard-Drucker-Interface generiert (LPll). Sie konnen man¬ 
chmal auch einen seriellen Drucker an einen Terminalausgang anschliessen. 
Achten Sie dann darauf, dass dieses Terminal in /etc/ttys nicht erscheint, so 
dass fur den Drucker keine Shell generiert wird. Mit stty konnen Sie 
Verzogerungen fur den Wagenriicklauf einstellen, oder CR oder CR LF als new- 
line einstellen. Siehe dazu 1/4 tty. 

Wir benutzen als Drucker einen Versatec V80. Dieser braucht leider sehr teures 
Spezialpapier und stinken tut er auch, aber er macht keinen Krach, bedruckt 
im Printmodus 1000 Zeilen in der Minute, und, was am besten ist, lasst sich als 
Ausgabeger&t fiir den troff nutzen. Dieses Papier wurde auf dem V80 erstellt. 
Wir hoffen sobald wie moglich einen kleinen Laserdrucker, z.B. den Canon 
LBP10, anschliessen zu konnen. 


•Profile 

In Ihrem login-directory sollte ein file mit dem Namen ".profile" existieren. Es 
enthalt Kommandos, die die Shell beim login ausfixhrt. Als Beispiel sehen Sie fol- 
gendes .profile-file: 

HOME=/ 

PATH=:/usr/ucb:/bin:/usr/bin 
MAIL=/usr/spool/mail/root 
export PATH 


Systemgenerierung 

Wir kommen nun zur eigentlichen Systemgenerierung. Unser Ziel ist es, ein Pro- 
gramm /unix zu erzeugen, das ohne Dialogteil ist, und alle notigen Treiber und 
nur diese enthalt. Dazu mvissen Sie im directory /usr/sys die Dateien c.c und l.s 
Sndern, und zwar nur die Zeilen, in denen der Kommentar /* MOD */ erscheint. 
In c.c und l.s erreichen Sie durch Ein-oder Auskommentieren, dass der 

f 
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betreffende Treiber mit dazugebunden wird oder nicht. Die anderen 
Anderungen in c.c verstehen sich hoffentlich von selbst. nldisp muss so gesetzt 
werden, dass in der Tabelle linesw der Multiplex-Treiber nicht mitgezahlt wird. 
Wollen Sie auf den Multiplextreiber verzichten, dann loschen Sie in der library 
lib2 die Module mxl.o und mx2.o. Statt dieser wird dann das Modul fakemx.o 
zum Kern dazugebunden, dass nur dazu dient, die unbefriedigten Referenzen 
abzus&ttigen. Nach Andern der beiden Dateien sagen Sie "make". Nun werden 
die Dateien fibersetzt und ein neues unix gebunden, das nach /nunix 
geschrieben wird. Booten sie /nunix, eventuell nachdem Sie es auf Floppy kopi- 
ert haben, und wenn es ordnungsgemass lauft, benennen Sie es nach /unix um. 
Das Unix, das Sie normalerweise laden, muss den Namen /unix tragen, damit die 
Programme ps und ss funktionieren. 

Wir gehen bei der Generierung anders vor als an der PDP. Dort wird ein unix 
mitgeliefert, das auf einer Minimalkonfiguration lauft. Wir fangen hingegen mit 
einem Maximal-unix (aunix) an, das, wie wir hoffen, auf alien Installationen zum 
Laufen gebracht werden kann. Es sollte trotzdem ein eigenes Unix erzeugt wer¬ 
den, um den lastigen Dialogteil loszuwerden, und um Speicherplatz fur nicht 
benbtigte Treiber freizugeben. 


Special files 

Wenn bei der Generierung ein Gerat nicht generiert wird, wird in den Tabellen 
in c.c ein leerer Eintrag (mit lauter nodev's) erzeugt, anstatt die betrefTende 
Zeile ganz wegzulassen. Das hat den Vorteil, dass an alien Installationen die 
Treiber uber dieselbe major device number angesprochen werden konnen. In 
Ihrem /dev-directory sollten alle special-file-entries stehen, und Sie sollten die 
nicht benotigten loschen. Siehe auch die Shell-Prozedur /mkdev. Nicht loschen 
dfirfen Sie die Eintrage ffir console, null, mem, kmem, tty. Der Eintrag ffir swap 
ist nur ffir die Programme ss und ps interessant. Der swap-Bereich wird von ps 
gefunden, indem es die Datei /dev/swap erbffnet, in der Symboltabelle von 
/unix nach der Adresse von swplo sucht, mit dieser Adresse in /dev/kmem liest, 
und mit dem gefundenen Wert von swplo als offset in /dev/swap liest. 


Standalone-Programme 

Im directory /sa stehen Programme, die auf der nackten Hardware laufen 
konnen. Dieselben Programme sollten auch auf Ihrer Boot-Floppy (ohne Prefix 
/sa) stehen. Diese Programme konnen entweder direkt vom Minitor geladen 
werden, oder vom Programm boot. Das Programm boot muss vom Minitor 
geladen werden, kann dann aber andere Programme von alien moglichen 
Geraten laden. Ausser boot existieren zur Zeit die Programme cat, mkfs und 
restor. Da die Programme ohne Parameter aufgerufen werden, muss ein 
Parameterdialog stattfinden. In diesem Dialog werden die Namen von Files 
einheitlich nach folgendem Muster gebildet: 

dev(unit,offset)name 

wobei dev gleich hb, rl, hk, rp, hp, rk, rx, tm oder ht ist, unit die physikalische 
(!) unit number angibt, offset ein physikalischer Offset in Blocken (oder tape- 
marks bei tm und ht) ist, und name entweder leer oder ein normaler unix- 
Pfadname ist. Eine logische unit l&sst sich als Kombination von physikalischer 
unit number und physikalischem Offset ansprechen. So ist z.B. die logische unit 
rlO gleich rl(0,0), rll gleich rl(0,10240), r!2 gleich rl(l,0) und rl3 gleich 
rl(l,10240). 

Beispiele: 
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hk(0,0)/sa/boot 

rl(l,10240)xxx 

tm(0,3) 

rx(3,0) 


hkO (root device), offset 0, File /sa/boot 
file xxx auf der zweiten Halfte von RL-Platte 1 
das dritte File auf dem : Magnetband. 

Floppy 1, double density 


Probieren Sie, boot zu laden, mit Hilfe von boot cat zu laden, und mit cat das 
File /etc/rc auszugeben. An unserer Installation geht das wie folgt, von der 
boot-Floppy aus: 

< Minitor: Laden von Floppy 

< Lade boot-Programm 

< Start 

> Prompt von boot 

< Floppy 0, double density, Programm cat 

> Ausgabe von cat 

< gewtinschtes File 
>*folgt Ausgabe von /etc/rc 
> l Ende von cat 

>TJeue Aufforderung von boot 

Die Standalone-Programme werden im wesentlichen zum Erzeugen und Sichern 
von Filesystemen benutzt. Sie konnen mit mkfs eine neue oder defekte Platte 
formatieren und mit restor einen friiheren Dump auf die Platte schreiben. 
Wenn Sie allerdings nur eine Festplatte haben, und keine Moglichkeit zur Daten- 
sicherung, werden Sie irgendwann grosse Probleme bekommen. 


rx 

/boot 

g 

boot : 

rx(2,0)cat 

File: 

hk(0,0)/etc/rc 


Exit called 
boot: 


Datensicherung 

Probleme mit der Datensicherheit entstehen in der Regel durch Unterschiede 
zwischen den Pufferblocken im Speicher und den Blocken auf der Platte. Wenn 
das System abgeschaltet wird, muss unbedingt vorher das Kommando sync 
gegeben werden, um alle geanderten Blocke auf die Platte zuriickzuschreiben. 
Im multiuser-Betrieb wird automatisch alle 30 Sekunden durch das Programm 
/etc/update ein sync gemacht. 


Der Unix-Kern ist stabil genug, dass er bei uns den ganzen Tag durchlauft. 
Wenn das System doch einmal absturzt, z.B. infolge memory parity, wird in der 
Regel noch ein sync durchgefiihrt. Wenn das System blockiert (sollte es 
natiirlich nicht), betatigen Sie erst die Halt-Taste am Rechner, um so das Sys¬ 
tem zu einem "ordnungsgemassen" Absturz zu bringen. Erst dann, oder wenn 
Sie sync gesagt haben, betatigen Sie die Init-Taste. 


Beim Hochfahren in den Multi-user-mode und nach einem Absturz sollten Sie 
standardmassig fsck aufrufen, um Inkonsistenzen zu erkennen und zu beheben. 
Auch die Programme icheck, ncheck, dcheck und clri erfiillen noch ihren 
Zweck. Die Reparatur von Platten besprechen wir im nachsten Abschnitt. 

Wenn eine Reparatur erfolglos ist, haben Sie hoffentlich immer schon Datensi¬ 
cherung gemacht. Am einfachsten ist es, eine Platte physikalisch auf eine 
andere zu kopieren. Haben Sie beispielsweise zwei mal RL02 Wechselplatten, 
konnen Sie die eine auf die andere (z.B. 0 auf 2, siehe oben) durch 

dd if=/dev/rrlO of=/dev/rrl2 bs=40b 

kopieren. Durch das Kopieren in 40*512 byte langen Blocken geht das sehr 
schnell. 
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•Am elegantesten geht Datensicherung naturlich mit dem Magnetband. Benutzen 
5ie dazu die Programme tar, dump und cpio. Tar und cpio haben den Vorteil, 
dass Sie sehr leicht einzelne Files oder directories von dem Band runterholen 
konnen. Find mit option -cpio gibt ihnen die Moglichkeit, Files mit einer bes- 
timmten Ejgenschaft (z.B. jfinger als .... grosser als ...) auf Band zu schreiben. 
Dump bietet als Vorteil den inkrementellen dump und das standalone-restor. 
Der ; grosse Nachteil von tar ist, dass keine special-files mitgedumpt werden. Es 
aei darauf hingewiesen, dass man den Band-Programmen auch immer, wegen 
der TJnlx-Fileunabhangigkeit, statt eines Bandgerats eine Platte angeben kann. 
Dumpen konnen Sie auch imlaufenden Betrieb. 

Sie miissen auf jeden Fall das root-filesystem mit dump sichern, um mit dem 
Standalone-Programm restor das System auch dann wiederherstellen zu 
konnen, wenn die Platte vollig zerstort ist. Die anderen Filesysteme lassen sich 
besser mit tar oder cpio sichern. 

Um den Benutzern zu helfen, die Datensicherung nur auf Floppys betreiben 
konnen, haben wir das dump-Kommando um die Option b size erweitert. size ist 
dabei die Grosse der Floppy in Blocken (500, 1001 oder 2002). Diese neue 
Option ist der Option s nachempfunden, die die Lange des Bandes in feet 
anzugeben erlaubt. Um also z.B. das filesystem rlO auf double sided, double 
density Floppies zu dumpen, geben Sie das Kommando 

dump Oubf 2002 /dev/rrx2 /dev/rrlO 

Das Programm dump wird automatisch eine neue Floppy anfordern, wenn die 
alte voll ist. 


Reparieren von Filesystemen 

Beim Plattenreparieren sollte die zu reparierende Unit nicht gemounted sein. 
Beim Root-device ist das nicht moglich. Hier arbeiten Sie am besten mit dem 
raw device, achten darauf, dass /etc/update nicht lauft, und betatigen nach 
Reparatur sofort die Init-Taste. Damit wird verhindert, dass fehlerhafte Blocke 
aus dem Speicher die reparierte Platte wieder fiberschreiben. Beachten Sie 
beim Reparieren, dass das block device fiber den Unix-Puffer-Kechanismus 
angesprochen wird, w&hrend das raw device direkt auf der Platte arbeitet. Ein 
"sync" bewirkt, dass block und raw device konsistent werden, indem die 
ge&nderten Blocke im Puffer auf die Platte zurfickgeschrieben werden. 

Die Re_paratur mit Hilfe von fsck ist in der Dokumentation ausffihrlich 
beschrieben. Benutzen Sie clri, wenn ein Inode so zerstort ist, dass er 
unmoglichc Blocknummern enthalt. Icheck und ncheck konnen Sie benutzen, 
um herauszufinden, in welcher Datei ein bad block steht. 



Herstellen einer Systemplatte 

Wenn Sie ein neues System mit Software auf Floppys oder Band bekommen, Oder 
wenn Sie Ihr root-fllesystem zerstort haben, miissen Sie das root-filesystem neu 
aufbauen. Dazu sind folgende Schritte erforderlich: 


1 . 

Formatieren Sie die Platte, falls erforderlich. 


2 . 



Booten Sie mkfs, z.B. von Floppy, durch Eingabe an den Minitor: rx, /boot, 
g, rx(2,0)mkfs. Mkfs fragt nach Dateinamen und filesystem-Grosse. 


Venn mkfs beendet ist .laden sie restor: rx(2,0)restor. restor fragt nach 
dem Eingabefile. Legen Sie nun das dump-Band oder die erste dump-Floppy 
ein und antworten Sie: tm(0,0) bzw. rx(2,0). restor fragt noch einmal, ob Sie 
sicher sind: Last chance before scribbling on ... . Drucken Sie <Return> 


Einfuhrende Lekture 

Aller Anfang ist schwer. Um Ihnen den Einstieg zu erleichtern, empfehlen wir, 
von Unix-Lehrbtichern abgesehen, das Studium der Manuale wie folgt: Zuerst 
die einfiihrenden Artikel im Handbuch II: "Summary", "The Unix Time- Sharing 
System", "Unix for Beginners", "A tutorial Introduction to the Unix Text Editor", 
"An Introduction to the Unix Shell”. Spielen Sie dann mit e:n paar Kommandos 
herum, die in 1/1 beschrieben sind, z.B. Is, echo, wc, who, be, cat, date, find, 
grep etc. Lernen Sie anschliessend einen Bildschirmeditor, wobei wir den ped 
empfehlen, da er viel einfacher als vi ist. Fur Leute, die tiefer ins System ein- 
steigen wollen, geht es dann weiter mit 11/29, 11/31 und 11/32, also "Setting up 
Unix", (Abs&tze uber special files, disk layout, new users und multiple users), 
’dann "Unix Implementation" und "The Unix I/O system". Diejenigen, die in C 
programmieren wollen, lesen dann 11/14 und 11/17, namlich 'The C Program¬ 
ming language" und, besonders wichtig, "Unix Programming". Wenn Sie soweit 
sind, werden die Kapitel 2 und 3 im Handbuch I interessant. Studieren Sie 
sorgfaltig die header-files in /usr/include und /usr/include/sys. Vor allem, 
benutzen Sie sie auch, um die Konsistenz und Portability Ihrer Programme zu 
erhohen. Bedenken Sie, dass unter Unix geschriebene Programme eine enorme 
Verbreitung erreichen konnen. 


Wenn Sie damn eigene Programme schreiben, wird es Sie vielleicht interessieren, 
wie man diese debuggen kann: mit adb (11/16) und pbug. L&uft das Programm 
dann, muss es dokumentiert werden. Fangen Sie am einfachsten mit den ms- 
Macros an (11/8), und steigen Sie dann etwas tiefer in nroff/trofl ein. Dabei 
lohnt es sich immer, die Original-Dokumentation in /usr/man und /usr/doc zu 
studieren. Werden Ihre Programme grosser, lernen und benutzen Sie make 
(11/16). Sind Sie bis dahin gekommen, lesen Sie alles nochmal durch und den 
Rest auch. Anschliessend wfirde ich Urlaub machen. 








MUNIX VI. 3 - Summary 


HUS 

Pfaelzer - Wald - Sir. 36 
8 WOO HIue nc he n VS 


Software iQCiiiti.es available on NUN i X 


Most of the programs available as MUNIX commands are listed 
in tins summary. Object code arid on-line manuals are dis¬ 
tributed for all of the listed software. 

Commands are se1f-oontained and do not require extra 
setup information/ unless specifically noted as interac¬ 
tive.'' interactive programs can be made to run from a 
prepared script simply by redirecting input. Most programs 
intended for interactive use le.g./ the edttorJ allow for an 
escape to command level Ithe ShellJ. Most file processing 
commands can also go from standard input to standard output 
i ' f i tiers" J. The piping facility of the Shell may be used 
to connect such filters directly to the input or output of 
other programs. 

MUNIX is based on UNIX* V?. Extensions and changes to 
V// which are visible to the user/ are marked with an *''. 


*UNIX is a Trademark of Bell Laboratories. 
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J . B Q5_i c So ft wore 

This includes the time-sharing operating system with utili¬ 
ties* a machine language assembler and a compiler for the 
programming language C. Lnough software to write and run new 
applications. 

1.1. Operating System 

MJNIX The basic resident code on which everything else 

depends. Supports the system calls* and maintains 
the file system. A general description of UNIX 
design philosophy and system facilities appeared 
in the Communications of the ACI’I* July* 1974. A 
more extensive survey is in the Bell System Techn¬ 
ical Journal for July-August 1978. Capabilities 
include: 

8 Reentrant code for user processes. 

U Separate instruction and data spaces. 

U "'Croup'' access permissions for cooperative 
projects* with overlapping memberships. 

8 Alarm-clock timeouts. 

8 Timer-interrupt sampling and interprocess moni¬ 
toring for debugging and measurement. 

8 Multiplexed I/O for machine-to-machine communi¬ 
cat ion. 

#DRIVtRS All I/O is logically synchronous. I/O devices are 
simply files in the file system. Normally* 
invisible buffering makes all physical record 
structure and device characteristics transparent 
and exploits the hardware's ability to do over¬ 
lapped I/O. Unbuffered physical record I/O is 
available for unusual applications. Drivers for 
the following devices and controllers are avail¬ 
able: 

8 Asynchronous interfaces: ULD11* terminal multi¬ 
plexer DZU11. Support for most common ASCII 
terminals. 

8 Parallel line printer: LPU11 
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0 Serial line printer UD3 with DLV-Hj interface 
U Versatec V80 printer plotter 
ft Magnetic tape: YU10 
a Floppy disks RX01/02 
U Disks: RLB1/02, RKBS/06/B7, RMB2 
a Honeywell Bull D120 with DRV t1 interface 
a Physical memory of QU6800B 
a Null device 
«DR1VEK-MAN1PULATI0N 

Force drivers to swap bytes, for exchanging data 
with foreign systems, especially DLL systems. 

a rxctrl: floppy driver 

a tmctrl: tape driver 

#FORMAY Procedures to format several devices. 

BOOT Procedures o get MUNIX started. 

*NEWCONF Make a new kernel from an already existing 

or from an u .eractively created configuration 
file. 

*WHATCONF Examine a MUN1X kernel, for what devices it is 
c o nfigured. 

t. 2. User Access Control. 

LOGIN Sign on as a new user. 

a Verify password and establish user's individual 
and group (.project} identity. 

a Adapt to characteristics of terminal. 

a Establish working directory. 

a Announce presence of mail Cfrom MAIL}. 

a Publish message of the day. 
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PASSWD 

NEWGRP 

j.3. T 
TABS 

S1TY 


*SEfI Y 


tt Execute user-specified profile. 

U Stort command interpreter or other initial pro¬ 
gram . 

Change a password. 

tt User can change his own password. 

U Passwords are kept encrypted for security. 

Change working group CprojectJ. Protects against 
unauthorized changes to projects. 

i_i ng_l Hand_Uns 

Set tab stops appropriately for specified terminal 
type. 

Bet up options for optimal control of the current 
output terminal. In so far as they are deducible 
from the input, these options are set automati¬ 
cally by LOUIN. 

it Half vs. full duplex. 

tt Carriage return+line feed vs. newline, 
tt I nt e rpret at i o n of tabs, 
tt P a r i i. y . 

tt Mapping of upper case to lower, 
tt Raw vs. edited input. 

tt Delays for tabs, newlines and carriage returns. 

Set up options for optimal control of other termi¬ 
nals. Analogous to STTY. 
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CAT 

Concatenate one or more files onto standard out¬ 
put. Particularly used for unadorned printing, 

for inserting data into a pipeline, and for 
buffering output that conies in dribs and drabs. 
Works on any file regardless of contents. 

#PACK 

Pack many files to one or unpack them. 

CP 

Copy one file to another, or a set of files to a 
directory. Uorks on any file regardless of con¬ 
tents. 

*PR 

Print files with title, date, and page number on 
every page. 

11 dulticolumn output. 

II Parallel column merge of several files. 

TAIL 

Print last n lines of input 

0 I'lay print last n characters, or from n lines or 
characters to end. 

*LINENO 

Print files with leading line numbers. 

LPR 

Off-line print. Spools arbitrary files to the 
line printer. 

*VPR 

Raster printer/plotter spooler. 

*UPR 

Spooler for the UD3 line printer. 

#PO 

Simple interactive display function for text 

files. 

CMP 

Compare two files and report if different. 

SUl'l 

Sum the words of a file. 

SPLIT 

Split a large file into more manageable pieces. 
Occasionally necessary for editing tEDJ. 

*1NT0 

Copy standard input until end of file to standard 
output. 

DD 

Physical file format translator, for exchanging 
data with foreign systems, especially IBM 378's. 
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4.S. Mo,nig>ui.otjLO.n of Directories and till Names 

KM Remove a file. Only the name goes away if any 

other names are linked to the file. 

8 Step through a directory deleting files 
interactively. 

0 Delete entire directory hierarchies. 


LN 

Link another name CaliasJ to an existing 

file. 

MU 

Move a 

file or files. Used for renaming 

files. 

CHI'IOD 

Change permissions on one or more files, 
able by files' owner. 

Ex e c ut- 

CHOWN 

Change 

owner of one or more files. 


CHSRP 

Change 

qroap (.project!) to which o file belongs. 

MKOIR 

Make a 

new directory. 


RHD1K 

Remove 

a directory. 


CD 

Change 

working directory. 


FIND 

Prowl the directory hierarchy finding every file 
that meets specified criteria. 


8 Criteria include: 

name matches a given pattern/ 

Creation date in given range* 
date of last use in given range* 
given permissions* 
given owner* 

given special file characteristics* 
boolean combinations of above. 

8 Any directory may be considered to be the root. 

8 Perform specified command on each file found. 
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J .6. 

SH 


TEST 

EXPR 


Runn_t n£ of Programs 


The Shell/ or command language interpreter. 

tt Supply arguments to and run any executable pro- 
gr am . 

P Redirect standard input/ standard output/ and 
standard error tiles. 

0 Pipes: simultaneous execution with output of 
one process connected to the input of another. 

11 Compose compound commands using: 
if ... then ... else/ 
case switches/ 
while loops/ 
for loops over lists/ 
break/ continue and exit/ 
parentheses for grouping. 

11 initiate background processes. 

H Perform Shell programs/ i.e./ command scripts 
with substitutable arguments. 

11 Construct argument lists from all file names 
satisfying specified patterns. 

P Take special action on traps and interrupts. 

tt User-settable search path for finding commands. 

U Executes user-settable profile upon login. 

11 Optionally announces presence of mail as it 
arrives. 

11 Provides variables and parameters with default 
setting. 

Tests for use in Shell conditionals. 

P String comparison. 

P Pile nature and accessibility. 

P Boolean combinations of the above. 

String computations for calculating command argu¬ 
ments. 
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WAIT 

READ 

ECHO 

SLEEP 

NOHUP 

NICE 

KILL 

CRON 


AT 

TEE 

*STKSIZ 


G Integer arithmetic 
0 Pattern matching 

Wait tor termination ot asynchronously running 
processes. 

Read a line from terminal/ tor interactive Shell 
pro ce dure. 

Print remainder ot command line. Usetul tor diag¬ 
nostics or prompts in Shell programs/ or tor 
inserting data into a pipeline. 

Suspend execution tor a specitied time. 

Run a command immune to hanging up the terminal. 

Run a command in low Cor high! priority. 

Terminate named processes. 

Schedule regular actions at specitied times. 

0 Actions are arbitrary programs. 

U Times are conjunctions ot month/ day ot month/ 
day ot week/ hour and minute. Ranges are 
specitiable tor each. 

Schedule a one-shot action tor an arbitrary time. 

Pass data between processes and divert a copy into 
one or more tiles. 

Change the stacksize ot a program. 
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J.7. Status iiiguiries 


*LS 

List the names of one/ several, or all files in 
one or more directories. 

tt Alphabetic or temporal sorting/ up or down. 

tt Optional information: size/ owner/ group/ date 
last modified/ date last accessed/ permissions., 
i-node number. 

FILE 

Try to determine what kind of information is in a 
file by consulting the file system index and by 
reading the file itself. 

^ DATE 

Print today's date and time. Has considerab l e 
knowledge of calendric and horological peculiari¬ 
ties. 

tl May set UNIX 's idea of date and time. 

OF 

Report amount of free space on file system dev¬ 
ices. 

DU 

Print a summary of total space occupied by all 
files in a hierarchy. 

*DLUNM 

Give the device name where a specified subdirec¬ 
tory is resident. 

OUOT 

Print summary of file space usage by user id. 

WHO 

Tell who's on the system. 

• 

tl List of presently logged in users/ ports and 
times on. 

tt Optional history of all logins and logouts. 

Try 

Print name of your terminal. 

PS 

Report on active processes. 

tt List your own or everybody's processes. 

tl Tell what commands are being executed. 

It Optional status information: state and schedul¬ 
ing i nfo/ priority/ attached terminal/ what 
it's waiting for/ size. 

f 
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#ss 

Report on system status. 

PWD 

Print name of your working directory. 


1.8. Backup and Maintenance 


MOUNT 

Attach a device containing a file system to the 
tree of directories. Protects against nonsense 
arrangeme nts. 

IJMOUNT 

Remove the file system contained on a device from 
the tree of directories. Protects against remov¬ 
ing a busy device. 

MKFS 

Make a new file system on a device. 

MKNOD 

Make an i-node Cfile system entry} for a special 
file. Special files are physical devices* virtual 
devices* physical memory* etc. 


TP 


TAR 

Manage file archives on magnetic tape. 

ft Collect files into an archive. 

ft Update DECtape archive by date. 

U Replace or delete DECtape files. 

ft Print table of contents. 

ft Retrieve from archive. 

*DUMP 

Dump the file system stored on a specified device* 
selectively by date* or indiscriminately. A 
multi-volume dump li.e. on floppies} is possible. 

RES TOR 

Restore a dumped file system* or selectively 
retrieve parts thereof. 

SU 

Temporarily become the super user with all the 
rights and privileges thereof. Requires a pass¬ 
word. 

#F SCK 

Kile system consistency check and interactive 
repair. 
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OCHECK 
ICHECK 


NCHECK 

Check consistency of tile system. 

tt Print gross statistics: number ot tiles, number 
ot directories, number ot special tiles, space 
used, space free. 

tt Report duplicate use of space. 

tt Retrieve lost space. 

It Report inaccessible files. 

tt Check consistency of directories. 

It List names of all files. 

CLRi 

Peremptorily expunge a file and its space from a 
file system. Used to repair damaged file systems. 

SYNC 

Force all outstanding I/O on the system to comple¬ 
tion. Used to shut down gracefully. 


_j . V. Ac count|ng 

The timing information on which the reports ore based can be 


manually 

cleared or shut off completely. 

AC 

Publish cumulative connect time report. 

0 Connect time by user or by day. 

tl For all users or for selected users. 

SA 

Publish Shell accounting report. Gives usage 

information on each command executed. 

tt Number of times used. 


tl Total system time, user time and elapsed time. 

tt Optional averages and percentages. 

It Sorting on various fields. 
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MAIL. 

Mail a message to one or more users. Also used to 
read and dispose of incoming mail. The presence 
at mail is announced by LUUIN and optionally by 
SH. 

1) Each message can be disposed of individuolly. 

It Messages can be saved in tiles or forwarded. 

CALENDAR 

Automatic reminder service tor events ot today and 
tomorrow. 

WRITE 

Establish direct terminal communication with 

another user. 

WALL 

Write to all users. 

MESU 

Inhibit receipt ot messages trom WRITE and WALL. 

CU 

Call up another time-sharing system. 

It Transparent interface to remote machine. 

II Filet ransmission. 

U Take remote input from local file or put remote 
output into local file. 

It Remote system need not be UNIX. 

UUCF 

UNIX to UNIX copy. 

II Automatic queuing until line becomes available 
and remote machine is up. 

It Copy between two remote machines. 

U Differences/ mail/ etc./ between two machines. 
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1.JJ. Bosjc Prgsrgm Oeve_l opme nt Tooj s 


Some of these utilities ore used os integral ports of the 
higher level languages described in section 2. 

AR 11a into in archives and libraries. Combines several 

files into one for housekeeping efficiency. 

tt Create new archive. 

tt Update archive by date. 

U Replace or delete files. 

a Print table of contents. 

a Retrieve from archive. 

#AS M68000-nacro-Assemb l er* 

implemented by CERN/'SILMLNS. 

a Most powerful instruction set of available 
assemble rs. 

a Creates object program consisting of 
code> possibly read-only 
initialized data 
uninitialized data. 

a Relocatable object code is directly executable 
without further transformation. 

a Object code normally includes a symbol table. 

a Multiple source files. 

a Conditional assembly. 

LIBRARY The basic run-time library. These routines are 
used freely by all software. 

a Buffered character-by-character I/O. 

a formatted input and output conversion CSCANF 
and PRINffJ for standard input and output* 
files* in-memory conversion. 

a Storage allocator. 

a Time conversions. 
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*ADB 


OD 


#XD 


8 Number conversions. 

8 Password encryption. 

0 Quicksort. 

a Random number generator. 

8 Mathematical function library* including tri¬ 
gonometric functions and inverses* exponential* 
logarithm* square root* bessel functions. 

Interactive debugger. 

8 Postmortem dumping. 

8 Examination of arbitrary files* with no limit 
on size. 

0 Interactive breakpoint debugging with the 
debugger as a separate process. 

0 Symbolic reference to local and global vari¬ 
ables. 

a Stack trace for C programs, 
a Output formats: 

1-, 2-* or 4-byte integers in octal* decimal* 
or hex 

single and double floating point 
character and string 
disassembled machine instructions 

a Patching. 

a Searching for integer, character* or floating 
patterns. 

8 Handles separated instruction and data space. 

Dump any file. Output options include any combi¬ 
nation of octal or decimal by words* octal by 
bytes, ASCII* opcodes, hexadecimal. 

8 Range of dumping is controllable. 

Hexadecimal file dump. 
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Link edit. Combine reiocotable object files. 

Insert required routines from specified libraries. 

II Resulting code may be sharable. 

II Resulting code may have separate instruction 
and data spaces. 

LORDER 

Places object file names in proper order for load¬ 
ing' so that files depending on others come after 
them. 

NM 

Print the namelist (.symbol table! of an object 
program. Provides control over the style and 
order of names that are printed. 

#SIZE 

Report the core requirements of one or more object 
files. 

STRIP 

Remove the relocation and symbol table information 
from an object file to save space. 

TIME 

Run a command and report timing information on it. 

PROF 

Construct a profile of time spent per routine from 
statistics gathered by time-sampling the execution 
of a program. 

0 Subroutine call frequency and average times for 
C programs. 

#MAKE 

Controls creation of large programs. Uses a con¬ 
trol file specifying source file dependencies to 
make new version; uses time last changed to deduce 
minimum amount of work necessary. 

11 Knows about CC, YACC, LEX, etc. 


J .J2. UNIX Programmer's Nonuoi 


MANUAL 

Machine-readable version of the UNIX Programmer's 
Manua(. 

II System overview. 

II All commands. 


U All system cal Is. 

II All subroutines in C and assembler libraries. 
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MAN 

1.13. 

Lfc.ARN 


tt All devices end other special tiles. 

U Formats of tile system and kinds ot tiles known 
to system software. 

8 Boot and maintenance procedures. 

Print specitied manual section on your terminal. 

6°«!£uter-Ai.de.d Instruction 

A program tor interpreting CA1 scripts* plus 

scripts for learning about UNIX by using it. 

U Scripts tor basic files and commands* editor* 
advanced files and commands* EUN* MS macros* C 
programming language. 
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2. Lgn.gug.ges 

2. J. The C Lgncjugge 

♦cCC Compile onef/or link edit programs in the C 

language. The UNIX operating system* most of the 
subsystems and C itself are written in C. For a 
full description of C* read ■The C Programming 
Language''* Brian W. Kernighan and Dennis PI. 
Ritchie* Prentice-Hall* 1V78. 

U lieneral purpose language designed for struc¬ 
tured programming. 

0 Data types include character* integer* float* 
double* pointers to all types* functions 
returning above types* arrays of all types* 
structures and unions of all types. 

I) Operations intended to give mach i ne-i nde pe nde nt 
control of full machine facility* including 
to-memory operations and pointer arithmetic. 

tt Macro preprocessor for parameterized code and 
inclusion of standard files. 

It All procedures recursive* with parameters by 
value. 

II Mac h i ne-i ndepe nde nt pointer manipulation. 

It Object code uses full addressing capability of 
the M68880. 

H Runtime library gives access to all system 
facilities. 

II Floating point arithmetic realized by software. 

It Definable data types. 

H Block structure 

LINT Verifier for C programs. Reports questionable or 

nonportable usage such as: 

Mismatched data declarations and procedure 
interfaces. 

Nonportable type conversions. 

Unused variables* unreachable code* no-effCect 
operations. 

Mistyped pointers. 

Obsolete syntax. 
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}| Full cross-module checking of separately com¬ 
piled pro grants. 

CB A beaut ifier for C programs. Does proper indenta¬ 

tion and placement of braces. 

2.2. Other Algorithmic Languages 

DC Interactive programmable desk calculator. Has 

named storage locations as well as conventional 
stack for holding integers or programs. 

U Unlimited precision decimal arithmetic. 

U Appropriate treatment of decimal fractions. 

a Arbitrary input and output radices* in particu¬ 
lar binary* octal* decimal and hexadecimal. 

U Reverse Polish operators: 

+ - * / 

remainder* power* square root* 
load* store* duplicate* clear* 
print* enter program text* execute. 

BC A C—like interactive interface to the desk i calcu¬ 

lator DC. 

a All the capabilities of DC with a high-level 
syntax. 

a Arrays and recursive functions. 

a Immediate evaluation of expressions and evalua¬ 
tion of functions upon call. 

a Arbitrary precision elementary functions: exp, 
sin* cos* at an. 

a Go-to-less programming. 

«FFPCALC Interactive programmable fast floating point desk 
calculator. 

a Fortran expression syntax 
a Optional assignement statement 
a Two variables X and Y 
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M4 


2 . A. 

YACC 


LEX 


- iy - 


It Functions: sqrt, power, log, exp, sin, cos, 
ton, otfliii sinh, cosh, tonh, obs, neg, conver¬ 
sion to integer, rounding. 


processing 


A general purpose macroprocessor. 

It St ream-oriented, recognizes macros anywhere in 
text. 

II Syntax tits with functional syntax of most 
higher-level languages. 

0 Can evaluate integer arithmetic expressions. 


£ ®i iT “£ o mp_i _l e r s 


An LRC 1.)-base d compiler writing system. During 
execution of resulting parsers, arbitrary C func¬ 
tions may be called to do code generation or 
sent ant ic actions. 

It BNF syntax specifications. 

II Precedence relations. 

It Accepts formally ambiguous grammars with non- 
BNF resolution rules. 

Generator of lexical analyzers. Arbitrary C func¬ 
tions may be called upon isolation of each lexical 
token. 

11 Full regular expression, plus left and right 
context dependence. 

II Resulting lexical analysers interface cleanly 
with YACC parsers. 
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3. l>xt P roceB§iii5 

3.J. Document Preparation 

£0 Interactive context editor. Random access to all 

lines of a file. 

U l-ind lines by number or pattern. Patterns may 
include, specified characters/ don't care char¬ 
acters/ choices among characters/ repetitions 
of these constructs/ beginning of line/ end of 
' line. 

J) Add/ delete/ change/ copy/ move or join lines. 

tt Permute or split contents of a line. 

U Replace one or all instances of a pattern 
within a line. 

t) Combine or split files. 

0 Escape to Shell Ccommand language! during edit¬ 
ing. 

0 Do any of above operations on every pattern- 
selected line in a given range. 

U Optional encryption for extra security. 

PIX Make a permuted Ckey word in context! index. 

SPELL Look for spelling errors by comparing each word in 

a document against a word list. 

U 2S/000-word list includes proper names. 

tt Handles common prefixes and suffixes. 

ti Collects words to help tailor local spelling 
lists. 

LOOK Search for words in dictionary that begin with 

specified prefix. 

CRYPT Encrypt and decrypt files for security. 
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3.2. Document Formattjno 


#VTROFF 


TROFF 

NROFF Advanced typesetting. TROFF drives q Graphic Sys¬ 

tems phototypesetter; NROFF drives ascii terminals 
of all types. VTROFF drives a raster 
printer/platter. TROFF * VTROFF and NROFF style is 
similar to RUFF (.not available on MUNIXi)/ but they 
are capable of much more elaborate feats of for¬ 
matting/ when appropriately programmed. TROFF/ 
VTRGFF and NROFF accept the same input language. 

tl All RUFF capabilities available or definable. 

II Completely definable page format keyed to 
dynamically planted ""interrupts'' at specified 
lines. 

II Maintains several separately definable typeset¬ 
ting environments Ce.g.z one for body text/ one 
for footnotes/ and one for unusually elaborate 
head i ngs'). 

t! Arbitrary number of output pools can be com¬ 
bined at will. 

II Macros with substitutable arguments/ and macros 
invocable in mid-line. 

II Computation and printing of numerical quanti¬ 
ties. 

U Conditional execution of macros. 

It Tabular layout facility. 

U Positions expressible in inches/ centimeters/ 
ems/ points/ machine units or arithmetic combi- 
nations thereof. 

It Access to charactei—width computation for 

unusually difficult layout problems. 

II Overstrikes/ built-up brackets/ horizontal and 
vertical line drawing. 

It Dynamic relative or absolute positioning and 
size selection/ globally or at the character 
level. 
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II Can exploit the characteristics of the terminal 
being used, for approximating special charac¬ 
ters/ reverse motions/ proportional spacing/ 
etc. 

The Graphic Systems typesetter has a vocabulary of several 
102-character fonts C 4 simultaneouslyJ in IS sizes. fROFh 
provides terminal output for rough sampling of the product. 

NROFF will produce multicolumn output on terminals capable 
of reverse line feed/ or through the postprocessor COL. 

High programming skill is required to exploit the formatting 
capabilities of TROFF and NROFF/ although unskilled person¬ 
nel can easily be trained to enter documents according to 
canned formats such as those provided by MS/ below. TROFF 
and EON are essentially identical to NROFF and NEON so it is 
usually possible to define interchangeable formats to pro¬ 
duce approximate proof copy on terminals before actual 
typesetting. The preprocessors MS and TBL are fully compa¬ 
tible with TROFF, NROFF and VTROFF. 

MS A standardized manuscript layout package for use 

with NROFF/TROFFor VTROFF. This document was foi— 
matted with MS. 

U Rage numbers and draft dates. 

II Automatically numbered subheads. 

II Footnotes. 

II Single or double column. 

II R aragraph i ng, display and indentation. 

U Numbered equations. 

EON A mathematical typesetting preprocessor for TROFF. 

Translates easily readable formulas, either in¬ 
line or displayed, into detailed typesetting 
instructions. 

II Automatic calculation of size changes for sub¬ 
scripts, sub-subscripts, etc. 

II Full vocabulary of Greek letters and special 
symbols, such as 'gamma', GAMMA', 'integral'. 

II Automatic calculation of large bracket sizes. 

It Vertical piling'' of formulae for matrices, 
conditional alternatives, etc. 
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NEON 

TBL 


GREEK 

COL 

DERUFF 

CHECKEO 


tt Integrals, sums> etc., with arbitrarily complex 
l i m 1 1 s. 

tt D i ocr i t i ca l&: dots, double dots, hats, bars, 
etc. 

tt Easily learned by nonprogrammers and mathemati¬ 
cal typists. 

A version of EON for NROF’F * accepts the same input 
language. Prepares formulas for display on any 
terminal that NROFF knows about, for example, 
those based on Diablo printing mechanism. 

tt Same facilities as EON within graphical capa¬ 
bility of terminal. 

A preprocessor for NROFF/TROFF that translates 
simple descriptions of table layouts and contents 
into detailed typesetting instructions. 

tt Computes column widths. 

tt Flandles left- and r i ght-j ust if i ed columns, cen¬ 
tered columns and decimal-point alignment. 

tt Places column titles. 

tt fable entries can be text, which is adjust; to 
f it. 

tt Can box all or parts of table. 

Fancy printing on Diablo-mechanism terminals tike 
DAS1--38G and DAS1-4S0, and on Tektronix 4014. 

U Gives half-line forward and reverse motions. 

it Approximates Greek letters and other special 
characters by overstriking. 

Canouicalize files with reverse tine feeds for 
one-pass printing. 

Remove all TROFF commands from input. 

Check document for possible errors in EON usage. 
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4 . Information Hq nd_(_» 


SORT 


TSORT 

UNIQ 


IR 


DIPT 


comm 


JOIN 


Sort or merge ASCII tiles line-by-line. No limit 
on input size. 

tt Sort up or down. 

U Sort lexicogrophico(ty or on numeric key. 

tt Multiple keys located by delimiters or by char¬ 
acter position. 

tt May sort upper case together with lower into 
dictionary order. 

tt Optionally suppress duplicate data. 

Topological sort - converts a partial order into a 
total order. 

Collapse successive duplicate lines in a tile into 
one line. 

tt Publish lines that were nally unique, 

duplicated, or both. 

tt May give redundancy count for each line. 

Do one-to-one character translation according to 
an arbitrary code. 

tt May coalesce selected repeated characters, 
tt May delete selected characters. 

Report line changes. additions and deletions 
necessary to bring two files into agreement. 

tt May produce an editor script to convert one 
file into another. 

tt A variant compares two new versions against one 
old one. 

Identify common lines in two sorted files. Output 
in up to 3 columns shows lines present in first 
file only, present in both. and/or present in 
second only. 

Combine two files by joining records that have 
identical keys. 
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GREP Print oil lines in a file that satisfy a pattern. 

tt May print all lines that fail to match. 

tt May print count of hits. 

tt May print first hit in each file. 

LOOK Binary search in sorted file for lines with speci¬ 

fied pref i x . 

WC Count the lines* ■‘words'' tblank-separated 

strings} and characters in a file. 

SED Stream-oriented version of ED. Can perform a 

sequence of editing operations on each line of an 
input stream of unbounded length. 

tt Lines may be selected by address or range of 
addresses. 

tt Control flow and conditional testing, 
tt Multiple output streams, 
tt Multi-line capability. 

AUK Pattern scanning and processing language. 

Searches input for patterns* and performs actions 
on each line of input that satisfies the pattern. 

ft Patterns include regular expressions* arith¬ 
metic and lexicographic conditions* boolean 
combinations and ranges of these. 

tt Data treated as string or numeric as appropri- 
at e. 

tt Can break input into fields* fields are vari¬ 
ables. 

tt Variables and arrays twith non-numeric sub¬ 
scripts}. 

tt Full set of arithmetic operators and control 
flow. 

tt Multiple output streams to files and pipes, 
tt Output can be formatted as desired. 

> 

tt Multi-line capabilities. 


October 2S* 1V02 



26 


£>. Noye 11 _i e s / B^ni e s > cud l.h.inss J. hj?l D_t d n ' i fcii 
Any Where EM se 

BANNER Print output in huge letters. 


BCD 

Converts ascii to card-image form. 

CAL 

Print a calendar of specified month and year. 

*P 1SH 

Children's card-guessing game. 

HANGMAN 

Or hang. Word-guessing game. Uses the dictionary 
supplied with SPELL. 

WUiZ 

Test your knowledge of Shakespeare/ Presidents/ 

capitals/ etc. 


*STARIREK Strategy game. Destroy the klingons. 


*TWINKLE 

twinklel or twinkle2. Milky way on the screen. 

UNi f S 

Convert amounts between different scales of meas¬ 
urement. Knows about hundreds of units. For exam¬ 
ple/ how many km/sec is a parse c/me gayear? 

*WORM 

Lead the worm to random points. 

*WURMS 

Several worms running around on screen. 

WIJMP 

Hunt the wurnpus/ thrilling search in a dangerous 
cave. 

WXCHU 

Give the hexadecimal code of any desired ASCII- 
character. 
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Deviations of HUNIX tH.U/N 

from NUNIX Uf.3 


PCS 

Pfaelzer - Wald - Str. 36 
WUUfc) Muenchen ykl 


NUNIX/N is created for small systems with only 16JNB 
storage. therefore three voluminous subjects of I'tUNIX 
omitted! 


U LHAKN/ the computer-aided instruction package 
W On-line manuals 


W Utilities for a Uersatec printer 


mass 

are 
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Unterschiede von Munix zu UNIXj Y7 



ABSTRACT 

Dieser Bericht beschreibt die Abweichungen unserer 
Implementierung von Unix V7 auf dem QU68000 gegenuber der 
PDP11 Version von Unix V7. 


1. Warum wurde geandert? 

Es gab mehrere gute Grvinde, um Anderungen durchzufuhren. Zunachst einmal 
wollten wir den grossen Adressraum des 68000 ausnutzbar machen, d.h. die 64k 
- Begrenzungen der PDP mussten fallen. Aufgrund der ganz anderen Segmen- 
tierung der QU68000 - Memory Management Unit waren wieder andere 
Anderungen durchzufuhren. Auf der PDP in Assembler geschriebene Module 
mussten nach C oder (seltener) 68000 Assembler umgeschrieben werden. Die 
unterschiedliche Hardware wird natiirlich auch in so maschinennahen Pro- 
grammteilen wie der Unterbrechungsbehandlung und den daraus entstehenden 
signals sichtbar. 


2. Vas wurde geandert? 

Unterschiede zur PDP11 Version ergeben sich auf 3 Arten: Software, die an der 
PDP, aber (noch) nicht am QU68000 lauft, Software, die am QU6B000, aber nicht 
an der PDP lauft, und Software, die am QU68000 anders als an der PDP ist. Wir 
behandeln hier nur die Software, die nicht oder die anders lauft. Unsere 
Erweiterungen werden anderswo beschrieben. Dabei bemuhen wir uns, die 
Anderungen schnellstmoglich in /usr/doc und /usr/man nachzuziehen. 


3. (Noch) fehlende Software 

Die folgende Liste halt sich an die Reihenfolge der Beschreibung im Unix - 
Manual I. Es wird immer eine kurze Begriindung gegeben, warum etwas nicht 

l&uft. 


tUNIX is a Trademark of Bel: Laboratories. 
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13.1. F&t>gramme (1/1) 

• arcv Kein Bedarf, da keine V6 auf dem QU68000 

tbas Leider in Assembler, hoffen anderswo ein Basic zu bekommen 

tenroll Enroll, xsend und xget brauchen ein multiple precision package. 
Ausserdemkein Bedarf fur Geheimhaltung bei uns 

: f>77 Fortran wird zur Zeit portiert 

factor Factor und primes sind in Assembler geschrieben 

■lookall Fur lookall, pubindex, refer und lookbib bisher kein Bedarf 

•mkcorif Konfigurierung am QU68000 anders als an der PDP 

•ratfor Ratfor und struct ohne Fortran sinnlos. Ratfor wird wahrscheinlich 
durch besseren Nachfolger EFL von Berkeley ersetzt 

roff In Assembler geschrieben, veraltet 

tc Tc und tk speziell fur Tektronix 4014/4015, diese nicht vorhanden 

uucp Uucp und uux laufen, benotigen aber unbedingt eine DZl 1-Hardware 

3.2. System calls (1/2) 

Ausser phys laufen alle system calls, auch mpx und pkon. phys wird nirgendwo 
verwendet. Sollte ein ahnlicher system call notwendig werden, lasst er sich 
leicht«inbauen. 


'3.3. library routines (1/3) 

Der packet driver simulator ist in Wirklichkeit nicht Bestandteil der standard 
library, sondern von uucp. Am QU68000 ist der packet driver Teil des Systems 
(siehe oben). 

3.4. Gera te treiber (1/4) 

Prinzipiell mvissten alle in Handbuch I Kapitel 4 genannten Treiber funk- 
tionieren, oder sehr schnell zum Funktionieren gebracht werden konnen. 
Daruber hinaus haben wir noch Treiber, die in Kap. 4 nicht aufgefiihrt sind, vor 
allem den RX02 Treiber. Getestet sind natiirlich nur die Treiber, fur die wir eine 
Hardware zur Verftigung hatten. An Platten bedienen wir zur Zeit RL01/02, 
RK05 und RK06/07. Die Umstellungszeit fur den RK05-Treiber betrug z.B. nur 
wenige Minuten. Die Treiber miissen jeweils etwas geandert werden, um iiber 
die DMA-Extension-Register den ganzen Speicher per DMA adressieren zu 
konnen. 


4. Anderungen 

Itn'folfeenden wird, wiederum in der Reihenfolge von Handbuch I, beschrieben, 
'#o Unterschiede zu V7 sind. Geandert wurden im wesentlichen maschinennahe 
Programme und header-files. 
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■4.1. Programme (1/1) 

Adb Standardmdssig erfolgt idie Au§gabe von Variablen und Parametern 
hexadezimal anstatt octal. Der Befehl SC (C backtrace) gibt von jeder 
Variablen die ersten 4 bytes hexadezimal aus. Bei Variablen mit einer 
L&nge n kleiner als 4 bytes heisst dies, dass nur die ersten n bytes zu 
beachten sind, im Falle von Registervariablen jedoch die letzten n 
bytes. Registervariablen wierden durch ein "<’ vor dem Namen 
kenntlich gemacht. Breakpoints iam Anfang einer Prozedur sollten den 
Offset 10 relativ zum Prozeduranfang haben, damit bei Erreichen des 
Breakpoints das neue Stackframe fertig ist. Bitte beachten Sie die 
Disassembler-Funktion i des ! Adb! 


as 



Der Assembler wurde am Cern (Hr. von'Eicken) in Pascal geschrieben. 
Sourcecode und Dokumentdtion sind Bestandteil dieser Distribution. 
Der Aufruf erfolgt einfach durchi ^filename 

Die Compileroption -Dwird ignoriert. Es gibt neue Optionen -L (Zeilen- 
nummern werden im Code mitgeTuhrt) und -a offset (im Assemblerlist¬ 
ing beginnt pc bei offset ). Bei Namen :sind die ersten 15 Buchstaben 
significant. Die Option -4 bestimmt, dass integers die Lange 4 bytes 
haben. Default ist sizeof(int) == 2. Die Sourcen von Compiler und 
Binder sind Bestandteil dieser Distribution. 


Id Die Binderoptionen -n. und -i werden ignoriert. Das erzeugte Programm 

ist immer "pure” und "shareable". Neu hinzugekommene Optionen 
unterschciden zwischen dcm Binden von Benutzerprogrammen, die 
unter Unix ablaufen, und Programmer die auf der nackten Maschine 
ablaufen sollen. Ferner kann eine Liste der Symbole erstellt werden. 

make Make "kennt" Pascal-files, d.h. es ruft automatisch den Pascal- 
Compiler auf, um eine Datei mit Suffix ”p" zu iibersetzen. 

man Wir verwenden jetzt das man von Berkeley. Dabei wird die Dokumenta- 
tion vorformatiert in directories;parallel zu den /usr/man-directories 
gehalten. Auf diese Weise wird die IManual-Page sehr schnell ausgege- 
ben. 


pr pr hat eine neue Option -n, die ein File mit Zeilennummern ausgibt, 

size Das size-Kommando gibt als vierte size die Stacksize des Programms 
aus. Der Wert 0 steht fvir die default-stacksize von 2 kbyte. 



4.2. System calls (1/2) 

brk Ein neuer systemcall lsbrk wird wie sbrk benutzt, hat aber einen long- 
Parameter 

exec Achten Sie bitte darauf, dass eine 10 als Parameter als (char *)0 oder 
NULL geschrieben wird. 

profil Die Nummer des Wortes in fbiiff, dass terhoht werden soil, berechnet 
sicb als (pc - offset) » scale.anstatt (pc - offset) * "0.scale". 

ptrace Der Parameter data ist long. Im Falle request=l bis 5 werden aber nur 
shorts gelesen oder geschrieben. Bei 1 request=6 wird entsprechend 
iem layout von u.vLjexvec mit Lange]4 geschrieben. Ein neuer Request 
io schreibt an die Adresse addr den ganzen u.u_exvec. Siehe in 
/usr/include/sys die files user.h und reg.h. 


9 
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: signal Es sind neue signals hinzugekommen. Siehe signal.h in /usr/include. 
wait rsiehe exec 

•4.3. library routines (1/3) 

Abort .abort generiert signal SIGILL (illegal instruction). 

rputw :putw und getw schreiben die bytes in der 68000-Reihenfolge, d.h. das 
: MSB zuerst. Zusatzlich gibt es Routinen getl und putl fur longs. 


-4.4. Treiber 

Wichtig ist nur, dass beim Terminal die Steuerzeichen anders sind. Interrupt ist 
Ctrl-C statt DEL, quit ist Ctrl-Y statt FS, eofc ist Ctrl-Z anstatt Ctrl-D, ein 
.Zeichen zu ioschen geht mit DEL Oder BS anstatt §. die ganze Zeile zu loschen 
geht mit Ctrl-X anstatt @. 


4.5. File-Formate und header-files 

а. out In a.out sind die unsigned Felder jetzt long. An magic numbers wird 

nur 0407 fur Module und 0411 fur fertige Programme erzeugt. 

5. floating Point 

Zur Zeit wird Floating Point vom Prozessor nicht unterstutzt Erst der 68020 
wird einen Floating Point Coprozessor haben. Bis dahin bietet Motorola ein 
"Fast Floating Point Package" an. Dieses kennt nur 32-bit floating point mit 24 
bit Mantisse und 7 bit Exponent. Der C-Compiler behandelt deshalb den typ 
double zur Zeit genauso wie den typ float. Um das FFP-Paket dazuzubinden, 
geben Sie beim cc-Kommando die Option -f an. 

б. finderungen am Kem 

6.1. Beschr&nkung der Programm-Grosse 

Der QU6B000 zerlegt den Adressraum in 16 Segmente d 1 Megabyte. Fur den 
Benutzer sind die Segmente 6 bis 14 reserviert. Zur Zeit wird jeweils ein Seg¬ 
ment fiir Code, Daten und Stack angelegt, d.h. von der MMU (Memory Manage¬ 
ment Unit) her kann ein Benutzer-Programm drei mal 1 Mbyte gross sein. Bei 
Bedarf konnen wir den Kern leicht so ver&ndern, dass z.B. der Datenbereich bis 
zu'7 Segmente belegen kann, auf Kosten eines langsameren context-switchs. 
Tatsachlich gibt es aber zur Zeit eine Beschrankung, die verhindert, dass die 
Summe von Stack und Daten grosser als etwa 250 kbyte werden kann. Diese 
Obergrenze entsteht wie folgt: 

Ein DMA-Gerat mit einem IB-bit Controller kann mit Hilfe der DMA-Extension- 
■Register am QU68000 zwar den gesamten ISpeicher adressieren, kann aber 
keinen Transfer fiber eine 256kb-Grenze hinweg durchffihren. Um nun zu 
veilhindern, dass ein Segment mit Code Oder Daten eine solche Grenze fiber- 
lappt, Vird zur Zeit ganz einfach bei der Erstellung der Freispeicherliste alle 
256 kb ein kleiner Bereich von 512 bytes freigelassen. Damit kann kein 
zusammenhangender Speicherplatz von mehr als 255 )£ kb reserviert werden. 
Diese Methode werden wir dann durch etwas besseres ersetzen, wenn das Limit 
von 256kb irgendwo schmerzhaft spfirbar wird. 
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6.2. Stackoverflow 

Der 68000 hat bisher noch keine bus-error-recovery. Damit ist ein automa- 
tisches Erweitern des Stacks bei Stackoverflow sehr schwer. Stattdessen stel- 
len wir das Kommando stksiz zur Verfiigung (Aufruf stksiz size file ... ), das das 
Programm/iZe mit einem Stack der Lange size ladt. Defaultmassig hat der Stack 
die Lange 2 kb. Stiirzt das Programm wegen Stackoverflow ab, miissen Sie 
stksiz mit einer grosseren size erneut aufrufen. Stackoverflow erkennen Sie mit 
dem adb, wenn bei Sr (show registers) der Wert von ns (exception number + cpu 
state) in den ersten zwei bytes gleich 2 ist (exception 2: bus error), der Wert 
von ac (access address) etwas kleiner als OxEFFFFF ist, und bei $m (show maps) 
der Wert von b2 in der "/ map (core)" etwas grosser als ac ist. 

Wenn der 68010 da ist, wird der Stack automatisch verlangert werden. 


6.3. Datenaustausch 

Um den Datenaustausch mit anderen Unix-Installationen zu vereinfachen, kann 
beim Lesen und Schreiben von Floppy und Band die Reihenfolge der Bytes ver- 
tauscht werden. Die Programme tmctrl fur Band und rxctrl fur Floppy haben 
einen Parameter -s, der das Vertauschen der bytes einschaltet. Der Parameter 
-i bei rxctrl schaltet auf der Floppy das Interleaving der Sektoren aus. Der 
Parameter -f formatiert die Floppy. Der Parameter -d stellt bei beiden Program- 
men die defaults wieder her. Zum Datenaustausch auf Band sollte das Pro¬ 
gramm tar benutzt werden. 

Das Programm "mt" zum Manipulieren von Bandern hat zusatzliche Parameter 
sw und nsw (swap und noswap), die byteswapping ein- und ausschalten. Das 
Programm cpio hat einen (niehtdokumentierten) Parameter s, der gleichfalls 
bytes swappt. Cpio-Baender von PDP oder VAX konnen mit " mt nsw, cpio -iBsvd 
filename </dev/rmt0 " gelesen werden. 


7. Blick in die Zukunft 

Wir gehen davon aus, dass die Entwicklung von Hardware und Software fur den 
QU68000 in nachster Zeit sehr sturmisch verlaufen wird. An Hardware- Entwick¬ 
lung haben wir folgende Meilensteine zu erwarten: 

Ein schneller lokaler Speicher wird die Prozessorgeschwindigkeit verdoppeln. 
Der neue Speicher wird auf die Software keinerlei Auswirkungen haben. W'enn 
die Hardware-floating-point-unit verfugbar ist, werden wir sehr schnell die rest- 
lichen Unix-Programme zum Laufen bringen. Insbesondere hoflen wir, Fortran 
bald zum Laufen zu bringen. Eine zweistufige Memory Management Unit mit 
paging wird ein echtes virtuelles Unix moglich machen. Wenn der 68010 
verfugbar ist, wird ein wachsender Stack automatisch verlangert werden. 
Bitmap-Displays und lokale Netze werden die Benutzer-Umgebung von Unix fun¬ 
damental andern. 

Die Weiterentwicklung der Software wird sich hoffentlich so abspielen, dass sich 
in steigendem Masse die Universitaten daran beteiligen. In naher Zukunft zu 
erwartende Projekte sind Tex/Metafont, Lisp, Prolog, Modula 2, Basic, Cobol, 
Fortran, paging unix, Adaptionen von System III und Berkeley Unix, Netzwerk- 
Software, Bitmap-Software, GKS, ADA, Emacs, Ingres etc. 
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ABSTRACT 

This user’s guide is intended for use in writing and translating 
assembly programs on 68000 UNIXt systems. The assembler is 
upward compatible with the M6B000 Cross Macro assembler pro¬ 
dded by Motorola. This guide restricts itself therefore to describ¬ 
ing the extensions provided by us. 

The Assembler 6B000 is a modified version of the CERK Cross 
Macro Assembler M6BMIL implemented in Pascal. Changes were 
made to write a.out format (the object module format coming with 
UNIX ) instead of CUF0M (CERN Universal Format for Object 
Modules). 


tUNIX is e Trademark of Beil Laboratories. 
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1. INTRODUCTION 

The Cross Macro Assembler described in this manual is derived from the CERN 
Cross Macro Assembler M68MIL but writes a.out object format instead of CUFOM. 
Some of the pseudo instructions were changed to provide the user with a means 
to control a.out segments instead of CUFOM sections. All other pseudo instruc- 
rtions, all machine instructions and the expression rules - as far as symbol types 
:are not concerned * are the same as for M68MIL and Motorola's Cross Assem¬ 
bler. 

The assembler translates assembler source programs for the Motorola 68000 
microprocessor into a.out. the format of UNIX loadable modules. A linkage editor 
subsequently allows the combination and linking of several such modules into a 
mew a.out module. An archiver (see ar(l)) permits the construction of a.out 
libraries, which can be placed in the input to the linkage editor. Besides, the 
assembler will accept source files 'piped' through the UNIX preprocessor cpp. 

The assembler is upward compatible with the M6B000 Cross Macro Assembler 
•provided by Motorola. Additional pseudo instructions are provided to allow the 
.generation of relocatable object modules. The user is advised to see the follow¬ 
ing Motorola publications: 

M68000 Cross Macro Assembler Reference Manual 
B68KXASM(D3), Third Edition, September 1979 

MC68000 16-Bit Microprocessor, User’s Manual 
MC6B000UM(AD2), Second Edition, January, 1980 

and the UNIX documentation 

UNIX Programmer’s Manual, Volume 1 (especially ar(l), ld(l), a.out(5) ) 

as a base for the use of this assembler. This manual will restrict itself to the 
description of the extensions made to the definitions of the Motorola cross 
assembler. For the readers' convenience this will be done in complete chapters 
rather than by listing the explicit differences. 

The main areas covered by this note are: 

Short description of a.out 
Expressions (generalized) 

Pseudo instructions 

Macro definitions 

How to use the assembler 


Acknowledgement: 1 would like to thank Mr. Horst von Eicken who gave us the 
Pascal sources and user manual of his CERN Cross Assembler. If you are 
interested in this assembler, please contact him at: 


Horst von Eicken 
Data Handling Division 
CERN 

CH 1211 Geneva 23 
Switzerland 
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2. SHORT BKSCMPnDN OF a.out 

In a.out modules code and data fall into three segments, the text segment, the 
data segment and the bss segment. The text segment is the one in which the 
assembler begins, and it is the one into which instructions are typically placed. 
The UNIX system can enforce the purity of the text segment of programs by 
trapping write operations into it (see ld(l)). 

The data segment is available for placing data or instructions which will be 
modified during execution. Anything which may go in the text segment may be 
put into the data segment. In programs with write-protected, shareable text 
segments, data segment contains the initialized but variable parts of a program 

The bss segment may not contain any explicitely initialized code or data. The 
length of the bss segment (like that of text or data) is determined by the high- 
water mark of the location counter within it. At the start of execution of a pro¬ 
gram the bss segment is set up by statements such as: 

lab dsl 2 

Another a.out convention concerns the entry point to a program: a program 
starts at a label _entry (which is typically defined by some runtime system and 
does some basic initialization) and branches then to a user-defined label _main. 
The user has to make sure that one and only one _main label is defined within 
her/his program. 

Since a.out modules are always relocatable it is not possible in an a.out 
module to allocate a label (symbol) at a certain absolute address - as it can 
be reached elsewhere by means of an org pseudo instruction - rather than 
by arranging the link-edit input appropriately (see ld(l)). org is supported 
for compatibility but it's limited. 
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3. SYMBOLS AND EXPRESSIONS 


3.1. ^Symbols 

Symbols recognized by the assembler consist of one or more characters, the 
first sixteen of which are significant. The first character must be a letter 
(a through zand A through Z) or an underscore (_). each remaining character 
may be a letter, a digit (0 through 9) or an underscore. The names for registers 
(aO through a7. dO through d7,sp,usp,ccr,sr ), instructions (abed .. unink) and 
pseudo instructions (blong .. ttl) are predefined symbols and may not be 
redefined by the user. 

a and A are different; predefined names must be written in lower case. 

Numbers recognized by the assembler include decimal, hexadecimal and octal 
values. Decimal numbers are specified by a string of decimal digits (0 through 
9); hexadecimal numbers are specified by a dollar sign (S). followed by a string 
of hexadecimal digits (0 through 9. A through F, a through f); octal numbers are 
specified by a colon (:), followed by a string of octal digits (0 through 7). 

One or more characters enclosed by apostrophes (’) constitute a character 
string. Character strings are left-adjusted and zero-filled (if necessary), 
whether stored or used as immediate operands. Only strings of four or fewer 
characters may be used as immediate operands. (In order to specify an apos¬ 
trophe within a character string, two successive apostrophes must appear 
where the single apostrophe is intended to appear.) 

The assembler has six types of symbols: 
absolute symbol: 

1. The symbol is equated ( equ ) or set to an absolute value. 

2. The symbol is equated ( equ ) or set to a constant. Its value is unaffected 
by any possible future applications of the link- editor to the module. 

text symbol: 

1. The symbol is equated ( equ ) or set to a text symbol. 

2. The symbol is defined in the text segment of the program. Its value is 
measured with respect to the beginning of the text segment of the pro¬ 
gram If the assembler output is link-edited, its text symbols may change in 
value since the module need not be the first in the link editor's output. At 
the start of an assembly the value of is text 0. 

data symbol: 

1. The symbol is equated ( equ ) or set to a data symbol. 

2. The symbol is defined in the data segment of the program. Its value is 
measured with respect to the beginning of the data segment of the pro¬ 
gram If the assembler output is link-edited, its data symbols may change 
in value since the module need not be the first in the link editor's output. 
After the first data pseudo instruction the value of is data 0. 
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fcss symbol: 

1. The symbol is equated ( equ) or set to a bsssyrhbol 

2. The symbol is defined in the bss segment of the program. Its value is meas¬ 
ured with respect to the beginning of the bss segment of the program Like 
text and data symbols, the value of a bss symbol may change during a sub¬ 
sequent link-editor run, since previously loaded programs may have bss 
segments. After the first bss pseudo instruction the value of is bss 0. 

external symbol: 

The symbol is listed in a extern pseudo instruction and is not defined in the 
current assembly. Its value is set to zero and must be defined during a sub¬ 
sequent link-editor run. 
undefined symbol: 

The symbol is neither defined in the current assembly nor listed in an 
extern pseudo instruction. The occurrence of such a symbol is indicated as 
an error. 

All symbols except absolute symbols are relative, i.e. they represent relocatable 
addresses. Whenever the assembler encounters a text, data, or bss symbol it will 
generate a direct address (see below) and related relocation information. To 
yield a program counter relative address write 

<rsym>(pc) or 
<rsym>(pc, <reg>) 

respectively. 

Symbols defined within an assembly as absolute, text, data, or bss symbol may 
be exported by occurring in a entry pseudo instruction, i.e. their value and 
their type are available to the link-editor so that the program may be loaded 
with others that reference these symbols. 


3.2. Expressions 

An expression is a combination of symbols, constants, algebraic operators, and 
parentheses. The expression is used to specify a value which is to be used as an 
operand. Expressions follow the conventional rules of algebra. 

Expressions may contain relative symbols. However the following rules must be 
followed in order for the expression to be valid: 

1. Relative symbols or expressions cannot be multiplied, divided, added, or 
operated on with the logical operators. 

2. A relative symbol or expression may have an absolute value added to or 
subtracted from it. The result is relative. 

3. A relative symbol or expression may be subtracted from another relative 
symbol or expression provided they are both defined and of same type. The 
result is absolute. 

3.3. Direct Addressing 

(The addressing mode discussed here is called 'absolute addressing mode' in 
the related Motorola documentation. Since those address values cannot be 
changed at run time, but may be changed during a link-edit run, they are 
referred to here as direct addresses to avoid confusion with absolute symbols 
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defined ealier in this manual.) 

Since the MSBOOO microprocessor allows two forms of direct addressing, 

- short direct address (16 bit address) - 

- long direct address (32 bit address) - 

the assembler has to take a decision as to which form to assume whenever it 
encounters -a forward referenced absolute symbol, i.e. a symbol which has not 
«et been defined, or a relative symbol, i.e. a symbol the value of which may be 
changed by the link-editor. By default it will use the long direct address to 
ensure correct bundling of the symbol. The pseudo instructions fshort, flong. 
text, data and bss will allow the programmer to override the assembler defaults. 
Assembling external symbols it will always use the long direct address mode. 

A similar problem exists for branches. If a forward reference is found in a 
branch instruction, the assembler will use the two-word form of the instruction. 
Using the suffix .s for the branch instruction the programmer can force the 
assembler to generate the one-word form of the branch instruction. The pseudo 
instructions bshort and blong allow additional control. 
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4. PSEUDO INSTRUCTIONS 

Pseudo Instructions discussed in this chapter are classified according to appli¬ 
cation as follows: 

Module identification (ident, end) 

Segment control (text, data, bss) 

Symbol definition (equ. set) 

Module linkage (entry, extern) 

Data generation and storage reservation (dc. ds. org) 

Conditional assembly (else, endc, endif, ifeq, ifne) 

Source stream control (insert) 

Listing control (list.g,nolist.page.nopage,sttl,ttl, fail) 

Object code control (blong. bshort, fiong. fshort, noobj) 

Cross reference control (xrefon, xrefoff) 

The next chapter describes the definition and use of macros. The format 
description for the pseudo instructions uses symbols which have the following 
syntactical meaning: 

l ] Enclose optional fields of the pseudo instruction. 

<..> Enclose a 'syntactic variable', e.g. <number>. 

4.1. Module Identification 

4.1.1. IDENT - Module Identification 

For compatibility with M6BMIL an ident pseudo instruction is accepted but is 
ignored. It has the following format: 

ident <symbol> 

<symbol> 

The symbol defines a name (originally that of the module). 

4.1.2. END - End of Module 

An end pseudo instruction must be the last instruction of each module It 
causes the assembler to terminate all counters, conditional assembly, or macro 
generation. It also causes the a.out module to be terminated. 

end j<symbol>J 

<symbol> 

An optional symbol is accepted - for compatibility - but ignored. The pro¬ 
gram main entrypoint is determined by the label _main as stated in the 
a.out description. 

4.2. Segment Control 

Segment control pseudo instructions allow the programmer to divide a source 
module into separately controlled regions of a program, providing her/him ■with 
a means of chang ing type and value of the location counter. They start or 
resume assembly for one of the three a.out segments. The segment in use is the 
segment into which code is subsequently assembled. By default the assembler 
will always start with the text segment using long direct address mode (see 3.3). 
If the suffix .s is appended to a segment control pseudo instruction, the assem¬ 
bler will assume that this segment will finally be loaded into low address 



- 10 - 


memory and use direct short addresses for backward references. 

The suffix .s does not imply that forward references in that segment will 
.also be resolved with direct short addresses, fshort must be used for this 
purpose. 

4.2.1. Text Segment 

text{.sj 

Description: 

The pseudo instruction causes the assembler to start or resume assembly 
in the text segment. 


4.2.2. Data Segment 

dataj.sj 

Description: 

The pseudo instruction causes the assembler to start or resume assembly 
in the data segment. 

4.2.3. Bss Segment 

bssj.s} 

Description: 

The pseudo instruction causes the assembler to start or resume storage 
allocation in the bss segment (uninitialized data: ds and org only). 

4.3. Symbol Definition 

4.3.1. EQU - Equate Symbol Value. 

<symbol> equ <expression> 

<symbol> 

A location symbol following the naming rules must be defined. 

<expression> 

An expression following the expression rules. Forward references are not 
allowed. 

Description: 

An equ pseudo instruction permanently defines the symbol in the location 
field as Jiaving the value and type indicated by the expression in the vari¬ 
able field. 


4.3.2. SET - Set or reset symbol value. 

<symbol> set <expression> 
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<symbol> 

A location symbol following the naming rules must be defined. 

<expression> 

An expression following the expression rules. Forward references are not 
allowed. 

Description: 

A set pseudo instruction defines the symbol in the location field as having 
the value and type indicated by the expression in the variable field. A sub¬ 
sequent set using the same symbol redefines the symbol to the new value 
and type. 


4.4. Module 1 .ink-age 

The pseudo instructions entry and extern do not define symbols but either 
declare symbols defined within a module as being available outside the module 
or declare symbols referred to in the module as being defined outside the 
module. 

4.4.1. ENTRY - Declare Entry Symbols 

entry <sym a > , <sym 2 > <sym XI > 

<syrn> 

Linkage symbol. Each symbol must be defined in the module as nonexter¬ 
nal (must not be listed on an extern pseudo instruction). 

Description: 

The entry pseudo instruction specifies which of the symbolic addresses 
defined in the module can be referred to by modules assembled indepen¬ 
dently; entry lists entry points to the current module. 


4.4.2. EXTERN - Declare External Symbols 

extern <symj> , <sym 2 > <sym n > 

<sym> 

Linkage symbol. These symbols must not be defined within the module. 
Description: 

The extern pseudo instruction lists symbols that are defined as entry 
points in independently assembled modules for which references can 
appear in the module being assembled. 


4.5. Data Generation and Storage Reservation 
4.5.1. DC - Define Constant 


{<symbol>} 

{<symbol>J 

£<symbol>J 

|<symbol>] 


dc <oprj> , <opr 2 > .... <opr n > 
dc.b <oprj> . <opr 2 > .... <opr n > 
dc.w <oprj> . <opr 2 > .... <opr n > 
dc.l <opr a > . <opr g > .... <opr n > 
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<symbol> 

A symbol following the naming rules may be defined. 

<°P r i> 

The operand can be a symbol, an ascii, decimal or hexadecimal value or an 
expression evaluating to such a value. 

Description: 

The function of the dc pseudo instruction is to define a constant in 
memory. The dc directive may have one operand, or multiple operands 
which are separated by commas. The operand field may contain a value 
(decimal, octal, hexadecimal, or character string), a symbol or a expres¬ 
sion. The constant is aligned on a word boundary if word.( .w) or long ( .1) is 
specified, or a byte boundary if byte ( .b) is specified. The constant is lim¬ 
ited to 60 bytes. 

The following rules apply to size specifications on character strings: 

dc.b If an odd number of bytes (characters) are entered, the odd byte on the 
right will be zero filled unless the next source statement is another dc.b 
or ds.b In this case the next dc.b or ds.b will start in the odd byte on the 
right. 

dc.w If an odd number of bytes (characters) are entered, the last word will be 
zero filled on the right to force an even byte count. 

dc.l If less than a multiple of four bytes are entered, the last long word will be 
zero filled on the right to a multiple of four bytes. 

4.5.2. DS - Define Storage 


|<symbol>! 

j<symbol>j 

j<symbol>j 

|<symbol>j 


ds <expression> 
ds.b <expression> 
ds.w <expression> 
ds.l <expression> 


<symbol> 

A symbol following the naming rules may be defined. 

<expression> 

The expression must evaluate to an absolute, positive value. 

Description: 

The ds pseudo instruction is used to reserve memory locations. The con¬ 
tents of the memory reserved are zero filled for text and data segment, for 
bss segment they are not initialized in any way. The expression must evalu¬ 
ate to an absolute value. Forward references are not allowed. 


4.5.3. ORG - Origin 

Since a.out modules are always relocatable the org pseudo instruction is appli¬ 
cable only in a very restricted manner: it can be used to advance the location 
counter a certain number of bytes or to a certain label. The skipped locations 
are zero filled. 


org <expression> 
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Description: 

The org pseudo instruction is used to advance the location counter 
<expression> bytes It's identical with 

ds.b <expression>* 

i.e. the expression must be of current segment type and evaluate to an 
value greater than the actual location counter. 


<4.6. Conditional Assembly 

The pseudo instruc ons ifeq and ifne permit optional assembly or skipping of 
source code. The instructions immediately following the test instruction are 
assembled if the tested condition is true and skipped if the condition is false. 
Skipping is terminated either by a source statement count on the if instruction, 
or by an endif, else or an end. The statement count, when used, is decremented 
for instruction lines only; comment lines (identified by * in column one) are not 
counted. 

The result of an if test is determined by the value of the expression in pass one 
of the assembler; the value of a relative symbol is relative to the origin of the 
segment in which it was defined. The value of an external symbol is zero if the 
symbol was declared as external. If the symbol was defined relative to a 
declared external, the value is the relative value, if ’s may be nested up to ten 
levels deep. 


4.6.1. ENDIF - End of IF Range 
$<if_name>} endif 

<if_name> 

An optional symbol, defines the name of an ifeq, ifne or else sequence; or 
blank. 

Description: 

An endif pseudo instruction (or endc for compatibility with the Motorola 
assembler) causes termination of skipping and assembly to resume. When 
the sequence containing the endif is being assembled, or is controlled by a 
statement count, the endif has no effect other than to be included in the 
count. 

Skipped instructions such as macro references are not expanded. Thus, 
any endif that would have resulted from an expansion is not detected. 

Skipping of a sequence initiated by an ifeq, ifne or else that is assigned a 
name is terminated by an endif specifying the same name. Skipping of a 
sequence initiated by an unnamed ifeq, ifne or else is terminated by an 
unnamed endif. 
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4.6.2. ELSE - Reverse Effects of IF. 

{<lf _name >} else 

<if_name> 

An optional symbol; defines the name of an ifeq, ifne or else sequence, or 
blank. 

Description: 

By means of the else instruction, the assembler provides the facility to 
reverse the effects of an if test within the if range. An else detected during 
skipping causes assembly to resume at the instruction following the else 
An else detected while a sequence is being assembled initiates skipping of 
source code following the else. Skipping continues until either an end or 
an ppHif for the sequence is detected. 

An else specifying the sequence by name terminates skipping of a sequence 
ini tiated by an ifeq or ifne with the same name An unnamed else ter¬ 
minates skipping of a sequence initiated by an unnamed ifeq or ifne 
Skipped instructions such as macro references are not expanded; any else 
that would have resulted from the expansion is not detected. 

4.6.3. IFEQ - Test Expression is Equal Zero. 

4.6.4. IFNE - Test Expression is Not Equal Zero. 

|<if_name>! ifeq <expression>$,<line_count>! 

(<if_name>j ifne <expression>$,<line_count>j 

<if_name> _ , , . 

An optional symbol, defines the name of the ifeq or ifne sequence; or blank. 

<expression> . , 

A simple expression without forward reference If the expression is errone 
ous, an error message is printed and assembly continues with the next 
instruction. 

<line_nount> . , , . . 

Optional absolute value specifying an integer count of the number of state¬ 
ments to be skipped. 

Description: , 

The ifeq and ifne pseudo instructions test the value of the expression and 
assemble instruction in the if range when the condition is satisfied. 

The <line_count>, if specified, takes precedence over an <if_name>, if specified 
at all. 
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4.7. Source Stream Control 


4.7.1. INSERT - Insert Secondary Source. 

insert 

Description: 

The insert pseudo instruction provides a means of obtaining source state¬ 
ments from a file other than that being used for input. The assembler 
transfers the text from this file and assembles it before taking the next 
statement from the interrupted source of statements. 

There are no parameters for the insert pseudo instruction. The file to be used is 
specified when the assembler is called (see 6.) The file will be rewound before 
using it. Under UNIX , the preprocessor cpp supports the inclusion of files and 
some other features, cpp may be used with the assembler (see 6.). Its usage is 
described in 

Kernighan B. W.; Ritchie D. M.: 

The C Programming Language. 

Prentice-Hall Software Series; Chapter 4.11 

4.8. listing Control 

The pseudo instructions described in this section permit extensive control of 
the assembly listing format. 


4.8.1. LIST - Listing 

list <opj> . <op 2 > <op n > 

<OPi> 

Optional parameter. A list option or a list option prefixed by a minus sign. 
The unprefixed option selects the option; the prefixed option cancels it. 
Options are separated by commas and terminated by a blank. The following 
options are available: 

dc 'When dc is selected, the source line of the dc pseudo instruction and its 
expansion are listed, otherwise only the source line will be listed 
-dc is the default. 

if When if is selected, the source lines of the ifeq, ifne, else or endif pseudo 
instructions and the skipped source statements in the if range are listed, 
otherwise the pseudo instructions are listed, but not the skipped source 
statements. 

-if is the default. 

macro 

When macro is selected, the source line of the macro reference and the 
fully expanded macro body are listed, otherwise only the source line of the 
outermost macro reference of possibly nested macro calls is listed. 

-macro is the default. 
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xopc 

’When xopc is.selected, the assembler will list the use of all opcodes in the 
cross reference list. 

-xopc is the default. 

xpse 

When xpse is selected, the assembler will list the use of all pseudo instruc¬ 
tion in the cross reference list. 

-xpse is the default. 

XTBg 

When xreg ist selected, the assembler will list the use of all registers in the 
cross reference list. 

-xreg is the default. 

Description: 

The list pseudo instruction controls the content and format of the assem¬ 
bler listing. Use of the list pseudo instruction is optional. If not specified in 
a module, or if specified without parameters, the assembler will produce an 
output according to the default for each possible option. 

For compatibility with the Motorola assembler the pseudo instruction g is also 
accepted. 

S 

Description: 

The effect of the g pseudo instruction is identical with the effect of 

list dc 

4.8.2. NOUST - Turn off Listing 

nolist 

nol 

Description: 

The nolist pseudo instruction suppresses the printing of the assembly list¬ 
ing until a list pseudo instruction is encountered. 


4.8.3. PAGE - Top of Page, 
page 

Description: 

The page pseudo instruction advances printer paper to a new page before 
printing. Then page headings are printed and listing continues. The page 
pseudo instruction does not appear on the program listing 


4.8.4. NOPAGE - Turn off Paging. 


nopage 
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Description: 

The nopage pseudo instruction suppresses paging to the output device. 
Page and line numbers in the cross reference and error listing -will be 
meaningless. 


4.B.5. SPC - Space Between Source lines, 
spc <count> 

<count> 

An absolute value. 

Description: 

The spc pseudo instruction causes the assembler to output <count> blank 
lines to the assembly listing. The spc pseudo instruction does not appear 
on the program listing. 


4.8.6. TTL - Assembly listing Title. 

4.B.7. STTL - Assembly listing Subtitle. 

ttl ’<text>’ 
sttl '<text>' 

Description: 

The ttl and sttl pseudo instruction allow the programmer to print a title 
and a subtitle on the top of each page of the listing. To this effect the 
assembler maintains internally two text strings which are set to blank at 
the beginning of pass one. Tn pass two, whenever a new page is started, 
these two text strings together with other information are printed in the 
page header. Specifying a tie or subtitle merely means, that the contents 
of the corresponding internal text string is changed to the one specified 
with the ttl or sttl pseudo instruction. It does not imply an automatic start 
of a new page. The first specified title is in addition kept in a third internal 
text string and is copied into the title text string at the start of pass two. 
Neither the ttl nor the sttl pseudo instruction are listed in the assembl}' 
listing. 


4.B.B. FAIL - Cenerate an Error Message, 
fail 

Description: 

An error message is printed on the assembly listing. 


4.9. Object Code Control 

The pseudo instructions blong, bshort, flong or fshort allow the programmer to 
influence the assembler's choice whenever forward references or relative sym¬ 
bols are encountered, be it for direct addresses or relative branching instruc¬ 
tions. 










4.9.1. BLONG - Use Two-Word Branch. 

4.9.2. BSHORT - Use One-Word Branch. 

blong 

bshort 


tteS °?he U( “two pseudo instructions blong and bshort allow the programme'- to 
influence the assembler whenever it is assembling a forward reference. B> 
default the assembler will use the two-word instruction form allowing a 
lief restive address range After a bshort pseudo instruction the assem- 
Wen LiH eenerate the one-word relative branch instruction, unless the 
suffiv l a® S pseudo Ltruction forces the two-word relative branch 
instruction to*be generated, unless the suffix s has been appended to that 
branch Instruction. 


4.9.3. FLONG - Force Direct Long Address. 

4.9.4. FSHORT - Force Direct Short Address. 


fiong 

fshort 


Description lnstructlons floD g and fshort allow the progr^nmer to 

tofluence’the assembler whenever it is assembling an direct address the 
label of which contains a forward reference. By default the assembler 
use the long direct address form. After an fshort pseudo instruction th 
assembler will generate the direct short address form. The occurrence of a 
flon^pseudo instnlction forces the direct long address form to be gen¬ 
erated. 


The selected option, long or short direct addresses is 
next occurrence of a flong. fshort or segment control ps 


only valid until the 
eudo instruction. 


4.9.5. NOOBJ - Suppress a.out Output, 
noobj 


Description: 

The pseudo instruction noobj suppresses 


the generation of a a.out module 
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4.10. Cross Reference Control 

The pseudo instructions allow the programmer to select whether a cross refer¬ 
ence listing shall be built up and printed at the end of the assembler listing. De¬ 
fault is xrefon. 

xrefon 

Description: 

A cross reference listing is built up and printed, 
xrefoff 
Description: 

A cross reference listing is suppressed. 
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5. MACRO OPERATIONS 

A macro definition is a sequence of source statements that are saved and then 
assembled whenever needed through a macro call. A macro call consists of the 
occurrence of the macro name in the operation field of a statement. It usually 
includes parameters to be substituted for formal parameters in the macro code 
sequence so that code generated can vary with each assembly of the definition. 

"Use of a macro requires two steps, definition of the macro, and calling of the 
definition. 

A definition consists of three parts: heading, body, and terminator. 


heading 


body 


terminator 


A macro definition is headed by a macro pseudo instruction stating 
the name of the macro. The heading optionally includes a local 
pseudo instruction identifying symbols local to the definition. 

The body begins with the first statement in a definition that is not a 
local pseudo instruction or a comment line. The body consists of a 
series of symbolic instructions. All instructions other than end or 
another macro definition are legal within a definition. The assem¬ 
bler recognizes substitutable arguments in all fields of the source 
line. The macro argument -0 however can only be used in the 
operation field for referring to the data size subparameter in an 
opcode or pseudo instruction. The arguments through -9 can 
appear anywhere in a source line. Ten is the maximum number of 
arguments that can be handled by any macro definition. Macro calls 
may be nested up to ten levels deep. 

An endm pseudo instruction terminates a macro definition. 


5.1. ENDM - End Macro Definition. 


endm 


An endm pseudo instruction terminates the macro definition. 

5.2. LOCAL - Local Symbols. 


local <sym : > , <symg> ,.., <sym n > 

<sym i > 

List of local symbols. Symbols must be separated by commas. A blank ter¬ 
minates the list. The maximum number of local symbols is 10. 

Description: 

The local pseudo instruction, which lists symbols local to the definition 
optionally follows the macro pseudo instruction. 

A symbol in the list is considered local to the macro; that is, it is known only 
within the macro definition. On each expansion of the macro, the assembler 
creates a new symbol for each local symbol and substitutes it for each 
occurrence of the local symbol in the definition. Thus invented symbols replace 
local named symbols wherever they appear in a macro definition in a manner 
similar to the way substitutable parameters are replaced. 




5.3. MACRO - Macro Heading. 
<m_name> macro 
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<m_name> 

A mandatory symbol that defines the name of the macro. 

Description: 

A macro pseudo instruction tells the assembler to place the instructions 
forming the body of the macro in a table of macro definitions for assembly 
upon call, and to place the macro name in the symbol table. 


5.4. MACRO CALLS 


A macro headed by a macro pseudo instruction can be called by an instruction 
in the following format: 


<symbol> 

<symboi> 

<symbol> 

<symbol> 

<symbol> 

<symbol> 

An optional 


<m_name> 

<m_name>.s 

<m_name>.b 

<m_name>.w 

<m_name>.l 

location symbol 


<Pj>, <p 2 >,.., 
<Pj>, <p 2 >„., 
<Pj>, <p 2 >.... 

<Pi>. <P 2 >.-. 
<Pi> • <P 2 > .... 


<Pn> 

<Pn> 

<P n > 

<P n > 

<Pn> 


<m_name> 

Name of a previously defined macro. The (optional) size attribute substi¬ 
tutes macro parameter 0 (see above). 

<Pi> 

Parameter list composed of strings of characters Parameters are 
separated by commas and terminated by a blank. Two consecutive commas 
constitute a null parameter. 

If null parameters are interspersed with non-null parameters, the correct posi¬ 
tions must be established with commas. When the list terminates before the last 
possible parameter, all remaining parameters are considered null. 


When the first character of a parameter is a left angle bracket ( < ), the assem¬ 
bler considers all the characters between it and the matching right angular 
bracket ( > ) as one parameter. The assembler removes the outer pair of angle 
brackets before substituting the enclosed character string in a line. Embedded 
brackets must be properly paired. A bracketed item can contain blanks and 
commas. 
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6. HOW TO USE THE ASSEMBLER 

The assembler has been designed as a two pass assembler and is written in Pas¬ 
cal. To run the assembler two input files (INPUT - assembler source, INSERT - 
accessed only by the insert pseudo instruction), two output files (OUTPUT - 
assembler listing, AOUT - a.out object module) and two work files (SCRATCH, 
XREFFIL) must be provided. 

Under UNIX the shell procedure os runs the preprocessor cpp and the assembler 
asm.. One or more assembler source files may be listed as arguments. There is 
no provision for assignment of INSERT since insertion can be achieved more 
conveniently by use of cpp Following UNIX convention, AOUT is written on a file 
named <name>.o, while the assembler sources should be named <name>.s. List¬ 
ings will be displayed to <name>.lst. 


<source>.s 

(assembler + cpp instructions) 



<source>.o <source>.ist 


Example 1: 

as mysource.s 
reads mysource.s 

displays the listing to mysource.lst, the object module to mysource.o 

Example 2: 

as mysource*.s 

reads mysourceO.s mysourcei.s mysourceS.s 

files the listings to mysourceO.lst mysource 1.1st mysource3.1st 

writes the object modules to mysourceO.o mysourcel.o mysource3.o 


Should you experience any problems or encounter errors, please contact the 
author. 
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7. APPENDIX 

Symbols and related address modes and relocation information 


symbol type 

textsegment 

datasegment 

absolute 

DA (r_abs) 

DA (r_abs) 

text 

PCD 16 (r_abs) 

DA (r_text) 

DA (r JLext) 

data 

DA (r_data) 

PCD! 6 (r_abs) 

DA (rJtext) 

bss 

DA (r Jt>ss) 

DA (r Jdss) 

external 

DA (r-jext) 

DA (r_ext) 


Notation: 

DA direct addressing mode 

PCD16 program counter relative addressing mode (generated if requested) 

Related relocation information 

r_abs (absolute symbol) 
r Jtext (text symbol) 
r_data (data symbol) 
r_bss (bss symbol) 
r_ext (external symbol) 









- 24 - 


list of Error Messages 

O:constant too large 

Ixharacter not defined for m 68000 assembler 
2:character missing or not valid for constant 
3:string too long or not terminated properly 
4:entry point or external symbol multiply defined 
5:entry point not defined 
7:symbol cannot be used as a label 
8:this operation needs a label 
9:this operation does not allow a label 
lO’symbol multiply defined 
12:symbol not defined 

13:initial ifeq or ifne is missing or misplaced 
14:the label of an if should not be used here 
15:if conditions more than maxinest levels deep 
16;symbol cannot be used as an opcode 
17:size specification illegal or not allowed 
18;macro expansion error 
19:more than maxmlocal local parameters 
20:at most one local pseudo per macrodefinition 
21 initial macro definition missing or misplaced 
22:macro calls more than maxmnest levels deep 
23:> expected 

24:do not nest macro definitions 

25:opcode/macro or pseudocode missing 

26:no such cross-reference option 

2B:operation needs one or more operands 

29:address or data register expected 

30:address register expected 

31:bad termination of an expression 

32:an expression cannot start with this symbol 

33:an operand cannot start with this symbol 

34:the count must be absolute for this pseudo 

35:the count must be positive for this pseudo 

36:the expression must be greater lc for org pseudo 

38:displacements are restricted to byte or word size 

40:argument(s) missing in expression 

41:displacement is restricted to byte size 

42:type conflict between address and program counter 

43:expression too complicated, use equ or set pseudo to break it down 

44:expression too large for size specified 

45:forward reference not allowed for this pseudo 

46:both arguments must be absolute for logical operations 

47:.s option does not allow branch to next word 

4B:register specification expected 

49:) expected 

50:) or . expected 

51 .separator expected 

52:no size specification for this operation 

53:byte size specification not allowed 

54:both arguments must be absolute for shift operations 

55:string expected 
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list of Error Messages (continued) 


56:too many operands are specified for this operation 
57:both arguments must be absolute for * or / 

5B:this address mode is illegal for the opcode 

59:address mode combination illegal for opcode 

60:do not write a comment on this line 

6 ^synchronization error between pass one and two 

62:too many errors this instruction line 

63:fail generated error, consult listing 

64:syntax error in register list for movem 

65 org argument is of illegal type 

68:no code generation in bss segment 

69:list options are: dc, if, macro, xopc, xpse, xreg 

70:one argument must be absolute for add operation 

71:illegal operand types for sub operation 

72:a.out buffers exceeded 
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FSCK—The UNIX File System Check Program 

T. J. Kowalski 

Bell Laboratories 
Murray Hill. New Jersey 07974 

ABSTRACT 

The UNIXt File System Check Program {fsck) is an interactive file system check and 
repair program. Fsck uses the redundant structural information in the UNIX file sys¬ 
tem to perform several consistency checks. If an inconsistency is detected, it is 
reported to the operator, who may elect to fix or ignore each inconsistency. These 
inconsistencies result from the permanent interruption of the file system updates, 
which are performed every time a file is modified. Fsck is frequently able to repair 
corrupted file systems using procedures based upon the order in which UNIX honors 
these file system update requests. 

The purpose of this document is to describe the normal updating of the file system, 
to discuss the possible causes of file system corruption, and to present the corrective 
actions implemented by fsck. Both the program and the interaction between the pro¬ 
gram and the operator are described. 

1. INTRODUCTION 

When a UNIX operating system is brought up, a consistency check of the file systems should 
always be performed. This precautionary measure helps to insure a reliable environment for 
file storage on disk. If an inconsistency is discovered, corrective action must be taken. No 
changes are made to any file system by .fsck without prior operator approval. 

The purpose of this memo is to dispel the mystique surrounding file system inconsistencies. It 
first describes the updating of the file system (the calm before the storm) and then describes 
file system corruption (the storm). Finally, the set of heuristically sound corrective actions 
used by./siA (the Coast Guard to the rescue) is presented. 

t 

2. UPDATE OF THE FILE SYSTEM 

Every working day hundreds of files are created, modified, and removed. Every time a file is 
modified, the UNIX operating system performs a series of file system updates. These updates, 
when written on disk, yield a consistent file system. To understand what happens in the event 
of a permanent interruption in this sequence, it is important to understand the order in which 
the update requests were probably being honored. Knowing which pieces of information were 
probably written to the file system first, heuristic procedures can be developed to repair a cor¬ 
rupted file system. 

There are five types of file system updates. These involve the super-block, inodes, indirect 
blocks, data blocks (directories and files), and free-list blocks. 

2.1 Super-Block 

The super-block contains information about the size of the fife system, the size of the mode 
list, part of the free-block iist, the count of free blocks, the count of free inodes, and part of 
the free-inode list. 

The super-block of a mounted file system (the root file system is always mounted) is written to 
the file system whenever the file system is unmounted or a sync command is issued. 


t UNIX is a Trademark of Bell Telephone Laboraiories. 
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2.2 Inodes 

An inode contains information about the type of inode (directory, data, or special), the number 
of directory entries linked to the inode, the list of blocks claimed by the inode, and the size of 
the inode. 

An inode is written to the file system upon closure 1 of the file associated with the inode. 

2.3 Indirect 3locks 

There are three types of indirect blocks: single-indirect, double-indirect and triple-indirect. A 
single-indirect block contains a list of some of the block numbers claimed by an inode. Each 
one of the 128 entries in an indirect block is a data-block number. A double-indirect block 
contains a list of single-indirect block numbers. A triple-indirect block contains a list of 
double-indirect block numbers. 

Indirect blocks are written to the file system whenever they have been modified and released- 
by the operating system. 

2.4 Data Blocks 

A data block may contain file information or directory entries. Each directory entry consists of 
a file name and an inode number. 

Data blocks are written to the file system whenever they have been modified and released by 
the operating system. 

2.5 First Free-List Block 

The super-block contains the first free-list block. The free-list blocks are a list ot all blocks that 
::ot allocated to the super-biock, inodes, indirect blocks, or data blocks. Each free-list block 
.tains a count of the number of entries in this free-list block, a pointer to the next free-list 
block, and a partial list of free blocks in the file system. 

Free-list blocks are written to the file system whenever they have been modified and released 
by the operating system. 

3. CORRUPTION OF THE FILE SYSTEM 

A file system can become corrupted in a variety of ways. The most common of these ways are 
improper shutdown procedures and hardware failures. 

3.1 Improper System Shutdown and Startup 

File systems may become corrupted when proper shutdown procedures are not observed, e.g.. 
forgetting to sync the system prior to halting the CPU, physically write-protecting a mounted 
file system, or taking a mounted file system off-line. 

File systems may become further corrupted if proper startup procedures are not observed, e.g.. 
not checking a file system for inconsistencies, and not repairing inconsistencies. Allowing a 
corrupted file system to be used (and. thus, to be modified further) can be disastrous. 

3.2 Hardware Failure 

Any piece of hardware can fail at any time. Failures can be as subtle as a bad block on a disk 
pack, or as blatant as a non-functional disk-controller. 

4. DETECTION AND CORRECTION OF CORRUPTION 

A quiescent 3 file system may be checked for structural integrity by performing consistency 
]. All in core blocks are also written to the tile system upon issue of a svin- system call. 

2. More precisely, they are queued for eventual writing. Physical I/O is deferred until the buffer is needed by IMX 
or a sync command is issued. 

3. I.e., unmounted and not being written on. 




FSCK 


3 


checks on the redundant data intrinsic to a file system. The redundant data is either read from 
the file system or computed from other known values. A quiescent state is important during 
the checking of a file system because of the multi-pass nature of the .fsck program. 

When an inconsistency is discovered fsck reports the inconsistency for the operator to chose a 
corrective action. 

Discussed in this section are how o discover inconsistencies and possible corrective actions for 
the super-block, the inodes, the indirect blocks, the data blocks containing directory entries, 
and the free-list blocks. These corrective actions can be performed interactively by the fsck 
command under control of the operator. 

4.1 Super-Block 

One of the most common corrupted items is the super-block. The super-block is prone to corr¬ 
uption because every change to the file system’s blocks or inodes modifies the super-block. 

The super-block and its associated parts are most often corrupted when the computer is halted 
and the last command involving output to the file system was not a sync command. 

The super-block can be checked for inconsistencies involving file-system size, inode-list size, 
free-block list, free-block count, and the free-inode count. 

4.1.1 File-System Size and Inode-List Size. The file-system size must be larger than the number 
of blocks used by the super-block and the number of blocks used by the list of inodes. The 
number of inodes must be less than 65.535. The file-system size and inode-list size are critical 
pieces of information to the fsck program. While there is no way to actually check these sizes. 
fsck can check for them being within reasonable bounds. All other checks of the rile system 
depend on the correctness of these sizes. 

4.1.2 Free-Block List. The free-block list starts in the super-biock and continues through the 
free-list blocks of the file system. Each free-list block can be checked for a list count out of 
range, for block numbers out of range, and for blocks already allocated within the file system. 
A check is made to see that all the blocks in the file system were found. 

The first free-block list is in the super-block. Fsck checks the list count for a value of less than 
zero or greater than fifty. It also checks each biock number for a value of less than the first 
data block in the file system or greater than the last block in the file system. Then it compares 
each block number to a list of already allocated blocks. If the free-list block pointer is non¬ 
zero, the next free-list block is read in and the process is repeated. 

When ail the blocks have be: accounted for, a check is made to see if the number of blocks 
used by the free-block rist plus the number of blocks claimed by the inodes equals the total 
number of blocks in the file system. 

If anything is wrong with the free-block list, then fsck may rebuild it, excluding all blocks in the 
list of allocated blocks. 

4.1.3 Free-Block Count. The super-biock contains a count of the total number of free blocks 
within the file system. Fsck compares this count to the number of blocks it found free within 
the file system. If they don’t agree, then fsck may replace the count in the super-block by the 
actual free-block count. 

4.1.4 Free-lnode Count. The super-block contains a count of the total number of free inodes 
within the file system. Fsck compares this count to the number of inodes it- found free within 
the file system. If they don’t agree, then fsck may replace the count in the super-block by the 
actual free-inode count. 

4.2 Inodes 

An individual inode is not as likely to be corrupted as the super-block. However, because of 
the great number of active inodes, there is almost as likely a chance for corruption in the inode 
list as in the super-block! 




4 


FSCK 


The lisi of inodes is checked sequentially starting with inode 1 (there is no inode 0) and going 
to the last inode in the file system. Each inode can be checked for inconsistencies involving 
format and type, link count, duplicate blocks, bad blocks, and inode size. 

4.2. J Formal and Type. Each inode contains a mode word. This mode word describes the type 
and state of the inode. Inodes may be one of four types: regular inode, directory inode, special 
block inode, and special character inode. If an inode is not one of these types, then the inode 
has an illegal type. Inodes may be found in one of three states: unallocated, allocated, and nei¬ 
ther unallocated nor allocated. This last state indicates an incorrectly formatted inode. An 
inode can get in this state if bad data is written into the inode list through, for example, a 
hardware failure. The only possible corrective action is for Jsck is to clear the inode. 

4.2.2 Link Count. Contained in each inode is a count of the total number of directory entries 
linked to the inode. 

Fsck verifies the link count of each inode by traversing down the total directory structure, start¬ 
ing from the root directory, calculating an actual link count for each inode. 

If the stored link count is non-zero and the actual link count is zero, it means that no directory 
entry appears for the inode. If the stored and actual link counts are non-zero and unequal, a 
directory entry may have been added or removed without the inode being updated. 

If the stored link count is non-zero and the actual link count is zero. Jsck may link the discon¬ 
nected file to the lost + found directory. If the stored and actual link counts are non-zero and 
unequal, fsck may replace the stored link count by the actual link count. 

4.2.3 Duplicate Blocks. Contained in each inode is a list or pointers to lists (indirect blocks) of 
all the blocks claimed by the inode. 

Fsck compares each biock number claimed by an inode to a list of already allocated blocks. If a 
block number is already claimed by another inode, the block number is added to a list of dupli¬ 
cate blocks. Otherwise, the list of allocated blocks is updated to include the block number. If 
there are any duplicate blocks. Jsck will make a partial second pass ot the inode list to find the 
inode of the duplicated block, because without examining the files associated with these inodes 
for correct content, there is not enough information available to decide which inode is cor¬ 
rupted and should be cleared. Most times, the inode with the earliest modify time is incorrect, 
and should be cleared. 

> 

This condition can occur by using a file system with blocks claimed by both the free-block list 
and by other parts of the file system. 

If there is a large number of duplicate blocks in an inode, this may be due to an indirect biock 
not being written to the file system. 

Fsck will prompt the operator to clear both inodes. 

4.2.4 Bad Blocks. Contained in each inode is a list or pointer to lists of all the blocks claimed 
by the inode. 

Fsck checks each block number claimed by an inode for a value lower than that of the first data 
block, or greater than the last block in the file system. If the block number is outside this 
range, the block number is a bad biock number. 

If there is a large number of bad blocks in an inode, this may be due to an indirect block not 
being written to the file system. 

Fsck will prompt the operator to clear both inodes. 

4.2.2 Size Checks. Each inode contains a thirty-two bit (four-byte) size field. This size indi¬ 
cates the number of characters in the file associated with the inode. This size can be checked 
for inconsistencies, e.g., directory sizes that are not a multiple of sixteen characters, or the 
number of blocks actually used not matching that indicated by the inode size. 
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A directory inode within the UNIX file system has the directory bit on in the inode mode word. 
The directory size must be a multiple of sixteen because a directory entry contains sixteen bytes 
of information (two bytes for the inode number and fourteen bytes for the file or directory 
name). 

Fsck will warn of such directory misalignment. This is only a warning because not enough 
information can be gathered to correct the misalignment. 

A rough check of the consistency of the size field of an inode can be performed by computing 
from the size field the number of blocks that should be associated with the inode and compar¬ 
ing it to the actual number of blocks claimed by the inode. 

Fsck calculates the number of blocks that there should be in an inode by dividing the number 
of characters in a inode by the number of characters per block (512) and rounding up. Fsck 
adds one block for each indirect block associated with the inode. If the actual number of blocks 
does not match the computed number of blocks, .fsck will warn of a possible file-size error. 
This is only a warning because UNIX does not fiil in blocks in files created in random order. 

4.3 Indirect Blocks 

Indirect blocks are owned by an inode. Therefore, inconsistencies in indirect blocks directly 
affect the inode that owns it. 

Inconsistencies that can be checked are blocks already claimed by another inode and block 
numbers outside the range of the file system. 

For a discussion of detection and correction of the inconsistencies associated with indirect 
blocks, apply iteratively Sections 4.2.3 and 4.2.4 to each level of indirect blocks. 

4.4 Data Blocks 

The two types of data blocks are plain data blocks and directory data blocks. Plain data blocks 
contain the information stored in a file. Directory data blocks contain directory entries. Fsck 
does not attempt to check the validity of the contents of a plain data block. 

Each directory data block can be checked for inconsistencies involving directory inode numbers 
pointing to unallocated inodes, directory inode numbers greater than the number of inodes in 
the file system, incorrect directory inode numbers for and and directories which are 
disconnected from the file system. 

If a directory entry inode number points to an unallocated inode, then fsck may remove that 
directory entry. This condition probably occurred because the data blocks containing the direc¬ 
tory entries were modified and written to the file system while the inode was not yet written 
out. 

If a directory entry inode number is pointing beyond the end of the inode list, fsck may remove 
that directory entry. This condition occurs if bad data is written into a directory data block. 

The directory inode number entry for should be the first entry in the directory data block. 
Its value should be equal to the inode number for the directory data block. 

The directory inode number entry for should be the second entry in the directory data 
block. Its value should be equal to the inode number for the parent of the directory entry (or 
the inode number of the directory data block if the directory is the root directory). 

If the directory inode numbers are incorrect, fsck may replace them by the correct values. 

Fsck checks the general connectivity of the file system. If directories are found not to be linked 
into the file system, fsck will link the directory back into the file system in the lost —found direc¬ 
tory. This condition can be caused by inodes being written to the file system with the 
corresponding directory data blocks not being written to the file system. 
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4.5 Free-List Blocks 

Free-list blocks are owned by the super-block. Therefore, inconsistencies in free-list blocks 
directly affect the super-block. 

Inconsistencies that can be checked are a list count outside of range, block numbers outside of 
range, and blocks already associated with the file system. 

For a discussion of detection and correction of the inconsistencies associated with free-list 
blocks see Section 4 1.2. 
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Appendix — FSCK ERROR CONDITIONS 

1. CONVENTIONS 

Fsck is a multi-pass file system check program. Each file system pass invokes a different Phase 
of the Jsck program. After the initial setup, fsck performs successive Phases over each file sys¬ 
tem. checking blocks and sizes, path-names, connectivity, reference counts, and the free-block 
list (possibly rebuilding it), and performs some cleanup. 

When an inconsistency is detected, ,/sck reports the error condition to the operator. If a 
response is required, fsck prints a prompt message and waits for a response. This appendix 
explains the meaning of each error condition, the possible responses, and the related error con¬ 
ditions. 

The error conditions are organized by the Phase of the Jsck program in which they can occur. 
The error conditions that may occur in more than one Phase will be discussed in initialization. 

2. INITIALIZATION 

Before a file system check can be performed, certain tables have to be set up and certain files 
opened. This section concerns itself with the opening of files and the initialization of tables. 
This section lists error conditions resulting from command line options, memory requests, 
opening of files, status of files, file system size checks, and creation of the scratch file. 

C option? 

C is not a legal option to Jsck: legal options are —y. -n. —s, —S. and — t. Fsck terminates on 
this error condition. See the./scA(lM) manual entry for further detail. 

Bad —t option 

The —t option is not followed by a fiie name. Fsck terminates on this error condition. See the 
/srA(lM) manual entry for further detail. 

Invalid —s argument, defaults assumed 

The — s option is not suffixed by 3. 4, or blocks-per-cylinder.blocks-to-skip. Fsck assumes a 
default value of 400 blocks-per-cylinder and 9 blocks-to-skip. See the Jsck( 1M) manual entry 
for more details. 

Incompatible options: —n and —s 

It is not possible to salvage the free-block list without modifying the fiie system. Fsck ter¬ 
minates on this error condition. See the./scA(lM) manual entry for further detail. 

Can’t get memory 

Fsck's request for memory for its virtual memory tables failed. This should never happen. 
Fsck terminates on this error condition. See a guru. 

Can’t open checklist file: F 

The default file system checklist file F (usually /erc/checklisi) can not be opened for reading. 
Fsck terminates on this error condition. Check access modes of F. 

Can’t stat root 

Fsck's request for statistics about the root directory failed. This should never happen. 
Fsck terminates on this error condition. See a guru. 
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Can’t stat F 

Fsck's request for statistics about the tile system F failed. It ignores this file system and contin¬ 
ues checking the next file system given. Check access modes of F. 

F is not a block or character device 

You have given fsck a regular file name by mistake. It ignores this file system and continues 
checking the next file system given. Check file type of F. 

Can’t open F 

The file system F can not be opened for reading. It ignores this file system and continues 
checking the next file system given. Check access modes of F. 

Size check: fsize X isize Y 

More blocks are used for the inode list Y than there are blocks in the file system X. or there 
are more than 65.535 inodes in the file system. It ignores this file system and continues check¬ 
ing the next file system given. See Section 4.1.1. 

Can’t create F 

Fsck's request to create a scratch file F failed. It ignores this file system and continues checking 
the next file system given. Check access modes of F. 

CAN NOT SEEK: BLK B (CONTINUE) 

Fsck's request for moving to a specified block number B in the file system failed. This should 
never happen. See a guru. 

Possible responses to the CONTINUE prompt are: 

YES attempt to continue to run the file-system check. Often, however the problem will 
persist. This error condition will not allow a complete check of the file system. A 
second run of Jsck should be made to re-check this file system. If the block was part 
of the virtual memory buffer cache, Jsck will terminate with the message "Fatal I/O 
error”. 

NO terminate the program. 

CAN NOT READ: BLK B (CONTINUE) 

Fsck's request for reading a specified block number B in the file system failed. This should 
never happen. See a guru. 

Possible responses to the CONTINUE prompt are: 

YES attempt to continue to run the file system check. Often, however, the problem will 
persist. This error condition will not allow a complete check ot the file system. A 
second run of Jsck should be made to re-check this file system. If the block was part 
of the virtual memory buffer cache, fsck will terminate with the message “Fatal I/O 
error”. 

NO terminate the program. 
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CAN NOT WRITE: BLK B (CONTINUE) 

Fsck's request for writing a specified block number B in the file system failed. The disk is 
write-protected. See a guru. 

Possible responses to the CONTINUE prompt are: 

YES attempt to continue to run the file system check. Often, however, the problem will 
persist. This error condition will not allow a complete check of the tile system. A 
second run of Jsck should be made to re-check this file system. If the block was part 
of the virtual memory buffer cache, Jsck will terminate with the message "Fatal I/O 
error”. 

NO terminate the program. 

3. PHASE 1: CHECK BLOCKS AND SIZES 

This phase concerns itself with the inode list. This section lists error conditions resulting from 
checking inode types, setting up the zero-link-count table, examining inode biock numbers for 
bad or duplicate blocks, checking inode size, and checking inode format. 

UNKNOWN FILE TYPE 1=1 (CLEAR) 

The mode word of the inode I indicates that the inode is not a special character inode, special 
character inode, regular inode, or directory inode. See Section 4.2.1. 

Possible responses to the CLEAR prompt are: 

YES de-ailocate inode I by zeroing its contents. This will always invoke the UNALLO¬ 
CATED error condition in Phase 2 for each directory entry pointing to this inode. 

NO ignore this error condition. 

LINK COUNT TABLE OVERFLOW (CONTINUE) 

An internal table for fsck containing allocated inodes with a link count of zero has no more 
room. Recompile fsck with a larger value of MAXLNCNT. 

Possible responses to the CONTINUE prompt are: 

> 

YES continue with the program. This error condition will not allow a complete check of 
the file system. A second run of fsck should be made to re-check this file system. 
If another allocated inode with a zero link count is found, this error condition is 
repeated. 

NO terminate the program. 

B BAD 1=1 

Inode 1 contains block number B with a number lower than the number of the first data block 
in the file system or greater than the number of the last block in the file system. This error 
condition may invoke the EXCESSIVE BAD BLKS error condition in Phase 1 if inode I has 
too many block numbers outside the file system range. This error condition will always invoke 
the BAD/DUP error condition in Phase 2 and Phase 4. See Section 4.2.4. 
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EXCESSIVE BAD BLKS 1 = 1 (CONTINUE) 

There is more than a tolerable number (usually 10) of blocks with a number lower than the 
number of the first data block in the file system or greater than the number of last block in the 
file system associated with inode I. See Section 4.2.4. 

Possible responses to the CONTINUE prompt are: 

YES ignore the rest of the blocks in this inode and continue checking with the next inode 
in the file system. This error condition will not allow a complete check of the file 
system. A second run of Jsck should be made to re-check this file system. 

NO terminate the program. 

B DUP 1=1 

Inode I contains block number B which is already claimed by another inode. This error condi¬ 
tion may invoke the EXCESSIVE DUP BLKS error condition in Phase 1 if inode I has too 
many block numbers claimed by other inodes. This error condition will always invoke Phase lb 
and the BAD/DUP error condition in Phase 2 and Phase 4. See Section 4.2.3. 

EXCESSIVE DUP BLKS 1 = 1 (CONTINUE) 

There is more than a tolerable number (usually 10) of blocks claimed by other inodes. See 
Section 4.2.3. 

Possible responses to the CONTINUE prompt are: 

YES ignore the rest of the blocks in this inode and continue checking with the next inode 

in the file system. This error condition will not allow a complete check of the file 

system. A second run of Jsck should be made to re-check this file system. 

NO terminate the program. 

DUP TABLE OVERFLOW (CONTINUE) 

An internal table in Jsck containing duplicate block numbers has no more room. Recompile 
Jsck with a larger value of DUPTBLS1ZE. 

Possible responses to the CONTINUE prompt are: 

YES continue with the program. This error condition will not allow a complete check of 
the file system. A second run of Jsck should be made to re-check this file system. 
If another duplicate block is found, this error condition will repeat. 

NO terminate the program. 

POSSIBLE FILE SIZE ERROR 1=1 

The inode I size does not match the actual number of blocks used by the inode. This is only a 
warning. See Section 4.2.5. 

DIRECTORY MISALIGNED 1 = 1 

The size of a directory inode is not a multiple of the size of a directory entry (usuaily 16). This 
is only a warning. See Section 4.2.5. 

PARTIALLY ALLOCATED INODE 1 = 1 (CLEAR) 

Inode I is neither allocated nor unallocated. See Section 4.2.1. 

Possible responses to the CLEAR prompt are: 

YES de-allocate inode I by zeroing its contents. 

NO ignore this error condition. 
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4. PHASE IB: RESCAN FOR MORE DUPS 

When a duplicate block is found in the file system, the file system is rescanned to find the 
inode which previously claimed that block. This section lists the error condition when the 
duplicate block is found. 

B DUP1=1 

Inode I contains block number B which is already claimed by another inode. This error condi¬ 
tion will always invoke the BAD/DUP error condition in Phase 2. You can determine which 
inodes have overlapping blocks by examining this error condition and the DUP error condition 
in Phase 1. See Section 4.2.3. 

5. PHASE 2: CHECK PATH-NAMES 

This phase concerns itself with removing directory entries pointing to error conditioned inodes 
from Phase 1 and Phase lb. This section lists error conditions resulting from root inode mode 
and status, directory inode pointers in range, and directory entries pointing to bad inodes. 

ROOT INODE UNALLOCATED. TERMINATING. 

The root inode (usually inode number 2) has no allocate mode bits. This should never happen. 
The program will terminate. See Section 4.2.1. 

ROOT INODE NOT DIRECTORY (FIX) 

The root inode (usually inode number 2) is not directory inode type. See Section 4.2.1. 

Possible responses to the FIX prompt are: 

YES replace the root inode’s type to be a directory. If the root inode's data blocks are 
not directory blocks, a VERY large number of error conditions will be produced. 

NO terminate the program. 

DUPS/BAD IN ROOT INODE (CONTINUE) 

Phase 1 or Phase lb have found duplicate blocks or bad blocks in the root inode (usually inode 
number 2) for the file system. See Section 4.2.3 and 4.2.4. 

Possible responses to the CONTINUE prompt are: 

YES ignore the DUPS/BAD error condition in the root inode and attempt to continue to 
run the file system check. If the root inode is not correct, then this may result in a 
large number of other error conditions. 

NO terminate the program. 

I OUT OF RANGE 1 = 1 NAME=F (REMOVE) 

A directory entry F has an inode number I which is greater than the end of the inode list. See 
Section 4.4. 

Possible responses to the REMOVE prompt are: 

YES the directory entry F is removed. _ 

NO ignore this error condition. 
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UNALLOCATED 1*1 0WNER=0 MODE=M SIZE*S \1T1ME=T NAME = F (REMOVE) 

A directory entry F has an inode 1 without allocate mode bits. The owner O, mode M. size S. 
modify lime T. and file name F are printed. See Section 4.4. 

Possible responses to the REMOVE prompt are: 

YES the directory entry F is removed. 

NO ignore this error condition. 

DUP/BAD 1*1 0WNER*0 MODE = M S1ZE=S MT1ME*T DIR = F (REMOVE) 

Phase 1 or Phase lb have found duplicate blocks or bad blocks associated with directory entry 
F, directory inode 1. The owner O, mode M. size S, modify time T. and directory name F are 
printed. See Section 4.2.3 and 4.2.4. 

Possible responses to the REMOVE prompt are: 

YES the directory entry F is removed. 

NO ignore this error condition. 

DUP/BAD 1 = 1 0WNER=0 MODE = M S1ZE*S MT1ME=T F1LE = F (REMOVE) 

Phase 1 or Phase lb have found duplicate blocks or bad blocks associated with directory entry 
F, inode 1. The owner 0. mode M. size S, modify time T, and file name F are printed. See 
Section 4.2.3 and 4.2.4. 

Possible responses to the REMOVE prompt are: 

YES the directory entry F is removed. 

NO ignore this error condition. 

6. PHASE 3: CHECK CONNECTIVITY 

This phase concerns itself with the directory connectivity seen in Phase 2. This section lists 
error conditions resulting from unreferenced directories, and missing or full lost+found direc¬ 
tories. 

UNREF DIR 1=1 0WNER*0 MODE = M SIZE=S MT1ME=T (RECONNECT) 

The directory inode 1 was not connected to a directory entry when the file system was 
traversed. The owner O, mode M, size S, and modify time T of directory inode 1 are printed. 
See Section 4.4 and 4.2.2. 

Possible responses to the RECONNECT prompt are: 

YES reconnect directory inode 1 to the file system in the directory for lost files (usually 
lost+JbuniD. This may invoke the lost+found error condition in Phase 3 if there are 
problems connecting directory inode 1 to lost + /bund. This may also invoke the 
CONNECTED error condition in Phase 3 if the link was successful. 

NO ignore this error condition. This will always invoke the UNREF error condition in 
Phase 4. 

SORRY. NO lost+found DIRECTORY 

There is no lost+found directory in the root directory of the file system': fsck ignores the 
request to link a directory in lost+found. This will always invoke the UNREF error condition in 
Phase 4. Check access modes of lost+found. See ,/sc*A( 1M) manual entry for further detail. 
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SORRY. NO SPACE IN lost + found DIRECTORY 

There is no space to add another entry to the lost+J'ound directory in the root directory of the 
file system; fsck ignores the request to link a directory in lost + found. This will always invoke 
the UNREF error condition in Phase 4. Clean out unnecessary entries in lost+Jound or make 
lost+found larger. See fsck(\W) manual entry for further detail. 

DIR 1*11 CONNECTED. PARENT WAS 1*12 

This is an advisory message indicating a directory inode II was successfully connected to the 
lost +found directory. The parent inode 12 of the directory inode II is replaced by the inode 
number of the lost+J'ound directory. See Section 4.4 and 4.2.2. 

7. PHASE 4: CHECK REFERENCE COUNTS 

This phase concerns itself with the link count information seen in Phase 2 and Phase 3. This 
section lists error conditions resulting from unreferenced files, missing or full lost+Jound direc¬ 
tory, incorrect link counts for files, directories, or special files, unreferenced files and direc¬ 
tories, bad and duplicate blocks in files and directories, and incorrect total free-inode counts. 

UNREF FILE 1=1 0WNER=0 MODE=M S1ZE=S MTIME*T (RECONNECT) 

Inode 1 was not connected to a directory entry when the file system was traversed. The owner 
O, mode M, size S, and modify time T of inode 1 are printed. See Section 4.2.2. 

Possible responses to the RECONNECT prompt are: 

YES reconnect inode 1 to the file system in the directory for lost files (usually 
lost+Jound). This may invoke the lost+J'ound error condition in Phase 4 if there are 
problems connecting inode I to lost + found. 

NO ignore this error condition. This'will always invoke the CLEAR error condition in 
Phase 4. 

SORRY. NO lost+found DIRECTORY 

There is no lost+found directory in the root directory of the file system; Jsck ignores the 
request to link a file in lost+Jound. This will always invoke the CLEAR error condition in 
Phase 4. Check access modes of lost+J'ound. 

SORRY. NO SPACE IN lost+found DIRECTORY 

There is no space to add another entry to the lost+J'ound directory in the root directory of the 
file system; Jsck ignores the request to link a file in lost+found. This will always invoke the 
CLEAR error condition in Phase 4. Check size and contents of lost+Jound. 

(CLEAR) 

The inode mentioned in the immediately previous error condition can not be reconnected. See 
Section 4.2.2. 

Possible responses to the CLEAR prompt are: 

YES de-ailocate the inode mentioned in the immediately previous error condition by 
zeroing its contents. 

NO ignore this error condition. 
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LJNK COUNT FILE 1=1 0WNER=0 MODE = \l SIZE=S MT1\1E=T COUNT = X SHOll.D 
BE Y (ADJUST) 

The link count for inode I which is a file, is X but should be Y. The owner O. mode M. size 
S. and modify time T are printed. See Section 4.2.2. 

Possible responses to the ADJUST prompt are: 

YES replace the link count of tile inode 1 with Y. 

NO ignore this error condition. 

LINK COUNT DIR 1 = 1 0WNER=0 V!ODE = M S1ZE=S MTIME=T COUNT = X SHOE LD 
BE Y (ADJUST) 

The link count for inode I which is a directory, is X but should be Y. The owner O, mode M. 
size S. and modify time T of directory inode I are printed. See Section 4.2.2. 

Possible responses to the ADJUST prompt are: 

YES replace the link count of directory inode I with Y. 

NO ignore this error condition. 

LINK COUNT F I=! 0WNER=0 MODE = .M S1ZE=S MT1ME=T COUNT-X SHOULD BE 
Y (ADJUST) 

The link count for F inode I is X but should be Y. The name F, owner O, mode M. size S. 
and modify lime T are printed. See Section 4.2.2. 

Possible responses to the ADJUST prompt are: 

YES replace the link count of inode 1 with Y. 

NO ignore this error condition. 

UNREF FILE 1 = 1 0WNER=0 MODE=M SIZE=S MT1ME=T (CLEAR) 

Inode I which is a file, was not connected to a directory entry when the file system was 
traversed. The owner O. mode M, size S. and modify time T of inode I are primed. See Sec¬ 
tion 4.2.2 and 4.4. 

Possible responses to the CLEAR prompt are: 

YES de-allocate inode I by zeroing its contents. 

NO ignore this error condition. 

UNREF DIR 1 = 1 0WNER=0 MODE=M S1ZE=S MT1ME=T (CLEAR) 

Inode I which is a directory, was not connected to a directory entry when the file system was 
traversed. The owner O, mode M, size S, and modify time T of inode I are printed. See Sec¬ 
tion 4.2.2 and 4.4. 

Possible responses to the CLEAR prompt are: 

YES de-allocate inode I by zeroing its contents. 

NO ignore this error condition. 
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BAD/DUP FILE 1 = 1 0WNER=0 MODE=M S1ZE=S \1T1ME=T (CLEAR) 

Phase 1 or Phase lb have found duplicate blocks or bad blocks associated with file inode 1. The 
owner O, mode M. size S. and modify time T of inode I are printed. See Section 4.2.3 and 
4.2.4. 

Possible responses to the CLEAR prompt are: 

YES de-ailocaie inode 1 by Zeroing its contents. 

NO ignore this error condition. 

BAD/DUP DIR 1 = 1 0WNER=0 MODE = M S1ZE=S MT1ME-T (CLEAR) 

Phase 1 or Phase lb have found duplicate blocks or bad blocks associated with directory inode 
I. The owner O, mode M, size S, and modify lime T of inode I are printed. See Section 4.2.3 
and 4.2.4. 

Possible responses to the CLEAR prompt are: 

YES de-allocate inode 1 by zeroing its contents. 

NO ignore this error condition. 

FREE INODE COUNT WRONG IN SUPERBLK (FIX) 

The actual count of the free inodes does not match the count in the super-block of the file sys¬ 
tem. See Section 4.1.4. 

Possible responses to the FIX prompt are: 

YES replace the count in the super-block by the actual count. 

NO ignore this error condition. 

8. PHASE 5: CHECK FREE LIST 

This phase concerns itself with v ee-block list. This section lists error conditions resulting 
from bad blocks in the free-biocK Lit, bad free-blocks count, duplicate blocks in the free-block 
list, unused blocks from the file system not in the free-block list, and the total free-block count 
incorrect. 

> 

EXCESSIVE BAD BLKS IN FREE LIST (CONTINUE) 

The free-block list contains more than a tolerable number (usually 10) of blocks with a value 
less than the first data block in the file system or greater than the last block in the file system. 
See Section 4.1.2 and 4.2.4. 

Possible responses to the CONTINUE prompt are: 

YES ignore the rest of the free-block list and continue the execution of Jsck. This error 
condition will always invoke the BAD BLKS IN FREE LIST error condition in Phase 
5. 

NO terminate the program. 
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EXCESSIVE DUP BLKS IN FREE LIST (CONTINUE) 

The free-block lisi contains more than a tolerable number (usually 10) of blocks claimed by- 
inodes or earlier parts of the free-block list. See Section 4.1.2 and 4.2.3. 

Possible responses to the CONTINUE prompt are: 

YES ignore the rest of the free-block list and continue the execution of./it k. This error 
condition will always invoke the DUP BLKS IN FREE LIST error condition in Phase 
5. 

NO terminate the program. 

BAD FREEBLK COUNT 

The count of free blocks in a free-list block is greater than 50 or less than zero. This error con¬ 
dition will always invoke the BAD FREE LIST condition in Phase 5. See Section 4.1.2. 

X BAD BLKS IN FREE LIST 

X blocks in the free-block list have a block number lower than the first data block in the file 
system or greater than the last block in the file system. This error condition will always invoke 
the BAD FREE LIST condition in Phase 5. See Section 4.1.2 and 4.2.4. 

X DUP BLKS IN FREE LIST 

X blocks claimed by inodes or earlier parts of the free-list block were found in the free-biock 
list. This error condition will always invoke the BAD FREE LIST condition in Phase 5. See 
Section 4.1.2 and 4.2.3. 

X BLK(S) MISSING 

X blocks unused by the file system were not found in the free-block list. This error condition 
will always invoke the BAD FREE LIST condition in Phase 5. See Section 4.1.2. 

FREE BLK COUNT WRONG IN SUPERBLOCK (FIX) 

The actual count of free blocks does not match the count in the super-block of the file system. 
See Section 4.1.3. 

Possible responses to the FIX prompt are: 

YES replace the count in the super-block by the actual count. 

NO ignore this error condition. 

BAD FREE LIST (SALVAGE) 

Phase 5 has found bad blocks in the free-block list, duplicate blocks in the free-block list, or 
blocks missing from the file system. See Section 4.1.2, 4.2.3. and 4.2.4. 

Possible responses to the SALVAGE prompt are: 

YES replace the actual free-biock list with a new free-biock list. The new free-block list 
will be ordered to reduce time spent by the disk waiting for the disk to rotate into 
position. 

NO ignore this error condition. 







FSCK 


9. PHASE 6: SALVAGE FREE LIST 

This phase concerns itself with the free-block list reconstruction. This section lists error condi¬ 
tions resulting from the biocks-to-skip and blocks-per-cylinder values. 

Default free-block list spacing assumed 

This is an advisory message indicating the blocks-to-skip is greater than the blocks-per-cylinder. 
the btocks-io-skip is less than one. the blocks-per-cylinder is less than one. or the blocks-per- 
cylinder is greater than 500. The default values of 9 blocks-to-skip and 400 blocks-per-cylinder 
are used. See the /scA(lM) manual entry for further detail. 

10. CLEANUP 

Once a file system has been checked, a few cleanup functions are performed. This section lists 
advisory messages about the file system and modify status of the file system. 

X files Y blocks Z free 

This is an advisory message indicating that the file system checked contained X files using Y 
blocks leaving Z blocks free in the file system. 

•••** BOOT UNIX (NO SYNC!) 

This is an advisory message indicating that a mounted file system or the root file system has 
been modified by fsck. If UNIX is not rebooted immediately, the work done by Jsck may be 
undone by the in-core copies of tables UNIX keeps. 

FILE SYSTEM WAS MODIFIED **■*""* 

This is an advisory message indicating that the current file system was modified by./kA. If this 
file system is mounted or is the current root file system, Jsck should be halted and UNIX 
rebooted. If UNIX is not rebooted immediately, the work done by fsck may be undone by the 
in-core copies of tables UNIX keeps. 
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INDEX OF MESSAGES 
(Alphabetically within each section) 


INITIALIZATION 

Bad —t option. 

C option?... 

CAN NOT READ: BLK B (CONTINUE) . . . 
CAN NOT SEEK: BLK B (CONTINUE) .... 
CAN NOT WRITE: BLK B (CONTINUE) . . . 

C'un'i create F. 

Can t get memory. 

Can't open checklist tile; F . 

Can't open F . 

Can't slat F. 

Can't slat root. 

F is not a block or character device . 

Incompatible options: —n and —s. 

Invalid —s argument, defaults assumed . . . . 
Size check: fsize X isize Y . 

PHASE 1: CHECK BLOCKS AND SIZES 



a bad ... 

a uup 1-1 . 

DIRECTORY MISALIGNED l-l. 

DUP TABLE OVERFLOW (CONTINUE) .. 

EXCESSIVE BAD BLKS l-l (CONTINUE). 

EXCESSIVE DUP BLKS 1-1 (CONTINUE) .. 

LINK COUNT TABLE OVERFLOW (CONTINUE). 

PARTIALLY ALLOCATED INODE I-l (CLEAR) . 

POSSIBLE FILE SIZE ERROR l-l . 

UNKNOWN FILE TYPE l-l (CLEAR). 


9 

in 

10 
if) 
10 
10 

9 

10 

10 

9 


PHASE IB: RESCAN FOR MORE DUPS 

BDUPl-l . 

PHASE 2: CHECK PATH-NAMES 

DUP/BAD l-l OWNER-O MODE-M SIZE-S MTIME-T DIR-F (REMOVE) . . . . 
DUP/BAD l-l OWNER—O MODE-M SIZE-S MTIME-T FILE-F (REMOVE) 

DUPS/BAD IN ROOT INODE (CONTINUE) . 

I OUT OF RANGE l-l NaME-F (REMOVE) . 

ROOT INODE NOT DIRECTORY (FIX) . 

ROOT iNODF. UNALLOCATED. TERMINATING. 

UNALLOCATED I —I OWNER—O MODE-M SIZE-S MTIME-T NAME-F (REMOVE* 



PHASE 3: CHECK CONNECTIVITY 


DIR 1-11 CONNECTED. PARENT WAS 1-12 . 

SORRY. NO SPACE IN losi + found DIRECTORY . 

SORRY. NO lost -‘-found DIRECTORY . 

UNREF DIR l-l OWNER-O MODE-M SIZE-S MTIME-T (RECONNECT) 


t 
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PHASE 4: CHECK REFERENCE COUNTS 

BAD/DUP DIR 1-1 OWNER-O MODE-M SIZE-S MTIME-T (CLEAR* . 

BAD/DUP FILE I-1 OWNER-O MODE-M SIZE-S MTIME-T (CLEAR).15 

(CLEAR). 

FREE INODE COUNT WRONG IN Sl'PERBLK (FIX).>5 

LINK COUNT DIR l-l OWNER-O MODE-M SIZE-5 MTIME-T COUNT-X SHOULD BE Y (ADJUST) U 
LINK COUNT FILE I-1 OWNER-O MODE-M SIZE-S MTIME-T COUNT-X SHOULD BE Y ( ADJUST) U 
LINK COUNT F I-I OWNER-O MODE-M SIZE-S MTIME-T COUNT-X SHOULD BE Y (ADJUST) . !■) 

SORRY. NO SPACE IN losi+found DIRECTORY .> 5 

SORRY. NO losi + found DIRECTORY . 1; 

UNREF DIR l-l OWNER-O MODE-M SIZE-S MTIME-T (CLEAR).l-> 

UNREF FILE l-l OWNER-O MODE-M SIZE-S MTIME-T (CLEAR) . 14 

UNREF FILE l-l OWNER-O MODE-M SIZE-S MTIME-T (RECONNECT) .I.’’ 

PHASE 5: CHECK FREE LIST 

BAD FREE LIST (SALVAGE). 16 

BAD FREEBLK COUNT. lh 

EXCESSIVE BAD BLKS IN FREE LIST (CONTINUE). 15 

EXCESSIVE DUP BLKS IN FREE LIST (CONTINUE). Ih 

FREE BLK COUNT WRONG IN SUPERBLOCK (FIX) . . . 

X BAD BLKS IN FREE LIST. 16 

X BLK(S) MISSING. 16 

X DUP BLKS IN FREE LIST. 16 

PHASE 6: SALVAGE FREE LIST 

Default free-block list spadna assumed. *' 

CLEANUP 

***** BOOT UNIX (NO SYNC!.. 17 

..... p, LE SYSTEM WAS MODIFIED.. 17 

X files Y blocks Z free. '' 
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Introduction 

This catalog gives samples of the various fonts available at Berkeley using 
vtrofl on our Versatec and Varian. We have them working 4 pages across in a 36 
inch Versatec, and rotated 90 degrees on a Benson-Varian 11 inch plotter. The 
same software should be adaptable to an 11 inch Versatec, and in fact is r unning 
at several other sites, however, not having one here, it isn't part of this distribu¬ 
tion. Such a driver is available from Tom Ferrin at UCSF. 

To use these fonts: 

(1) Hershey. This is the default font. The Hershey font is currently the only 
complete font, with all 16 point sizes and all the special characters troll 
knows about. To get it, use vtrofl directly. To illustrate this with the -ms 
macro package: 

vtrofl —ms paper.nr 

(2) Fonts with roman, italic, and bold, such as nonie. You can load all three 
fonts with, for example: 

vtrofl ~F nonie -ms paper.nr 

To get just one of these fonts, use (3) below, appending .r, .i. or .b to the 
font name to specify which font you want mounted, e.g., to get italics in 
delegate, 

vtrofl —2 delegate.i —ms paper.nr 

(3) To get a font without a complete set, choose which font (1, 2, or 3) you want 
replaced by the chosen font. For example, to use bocklin as though it were 
bold, since font 3 is bold, use: 

vtrofl —3 bocklin -ms paper.nr 
To switch between fonts in troff, use 


.ft 3 

to switch to font 3, for example, or use 

\f3word\fl 

to switch within a line. For more information see the Nroff/Troff Users Manual. 

Special note: troff thinks it is talking to a CAT phototypesetter. Thus, it 
does all sorts of strange things, such as enforcing restrictions like 7.54 inches 
maximum width. 4 fonts, a certain 16 point sizes, proportional spacing by point 
size. etc. 

In particular' the following glyphs will always be taken from the special 
font, no matter what font you are using at the time: 

©, #, ”, '. \ <. >, \. J. ■*, and — 

This may explain what are otherwise surprising results in some of the subse¬ 
quent pages. 

In addition, the following Greek letters have been decreed by troff as look¬ 
ing so much like their Roman counterparts that the Roman version (font 1) is 
always printed, no matter what font is mounted on font 1 at the time: 

A, B. E. Z. H. I. K. M. N, 0, P. T. X. 

(See table II in the back of the Nroff/Troff Users's Manual for details about what 
glyphs are in each font and how to generate the special glyphs.) 
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API FONT, 10 POINT ONLY 


AccBlCnDiEt F.CvHMU-K' LUMmOoP • <??R P .SrT~I/i VuW laYTZc 01234 56709 

( " # t • * i v a S ii ♦ - { } j j - 3©-»<*/\.>,< 

Baskeryille font, roman, ibold, italic, 12 point only (Called Tjasker’ on line.) 


ABCDE FCHIJ KLMNO PQRST UVWXY2 abcde fghij kJmno pqrst uvwxyz 01234 56789 
!"#$*&’():*-«[] [ ] ~ ~ _\ | ©';♦/?.>, < 

If time be of all things the most precious, wasting time must be, as Poor Richard says, the greatest 
prodigality, since, as he elsewhere tells us, lost time is never found again; and what we call time 
enough, always proves little enough: Let us then up and be doing, and doing to the purpose; so by 
diligence shall we do more with less perplexity. 


ABCDE FCHIJ KLMNO PQRST UVWXYZ abcde fghij Umno pqrst uvwxyz 01234 56789 
1 " # $ Z Id ' ( ) .•* - - / ; [ j - - _\ I © ‘ ; ♦ / ?. > , < 

If time be if all things the most precious, wasting time must be, as Poor Richard says, the greatest 
prodigality; since, as he elsewhere tells us, lost time is never found again; and what we call time 
enough, always proves little enough: Let us then up and be doing, and doing to the purpose; so by 
diligence shall we do more with less perplexity. 


ABCDE FGHIJ KLMNO PQRST UVWXYZ abcde fghij kimno pqrst uvwxyz 01234 56789 
! " # S * 8c ' ( ) : * - - [ ] [j - ~ _\ | @ ‘; ♦ / ? . > , < 

If time be of ail things the most precious, wasting time must be, as Poor Richard says, the 
greatest prodigality since, as he elsewhere tells us, lost time is never found again; and what we 
call time enough, always proves little enough: Let us then up and be doing, and doing to the 
purpose; so by diligence shall we do more with less perplexity. 






Bochlin Iont. 14 and 28 point only. 


14 point 

HBCBE FW3 KLHR0 PQRST STVWXTR abode Ighi] kimno pqrst uvwxyz 
01234 56739 

" ():- = !! /? . * 

H time be ol all things the most precious, wasting time must be. as Poor 
Richard says, the greatest prodigality; since, aslie elsewhere tells us. 
lost time is never found again; and what we call time enough, always 
proves little enough: Let us then up and be doing, and doing to the 
purpose; so by diligence shall we do more with less perplexity. 

28 point (Ro punctuation except period.) 

ftBCBE FGTO KLSR0 PQRST 
d.VWXY2i abede fghij hlmno pqrst 
uvwxyz 01234 56789 . 

II time be of all things the most 
precious wasting time must be as 
Poor Richard says the greatest 
prodigality since as he elsewhere 
tells us lost time is never found 
again and what we call time enough 
always proves little enough Let us 
then up and be doing and doing to 
the purpose so by diligence shall we 
do more with less perplexity. 





Bodoni font, roman, bold, italic , 10 point only. 


ABCDE FCHU KLMNO PQRST UTWXTZ abode fghij klmno pqrst uvwxyx 01234 56789 

If time be of all thing! the most precious wasting time must be, as Poor Richard gays, the greatest 
prodigality; since, as he elsewhere talk as, lost time is never found again; and what we call time enough, 
always proves little enough: Let us then up and be doing, and doing to the purpose; so by diligence shall we 
do more with less perplexity. 

ABCDE FCHIJ KLMNO PQRST UVWXYZ abed e fghij klmno pqrst uvwxyz 01234 56789 

/"#** ©';*/?. >. < 

If time bo of all things the most precious, i casting time must he, os Poor Richard says* the greatest 
prodigality; since, as he elsewhere tells us, lost time is never found again; and what we call time 
enough, always proves little enough Let us then up and be doing, and doing to the purpose; to by 
diligence shall we do more with less perplexity. 

ABCDE FGHU KLMNO PQRST UVVXYZ abode fghij klmno pqrst uvwxyx 01234 56789 
!”#«!*’():*-•[]{} « 5 */?.>,< 

If time be of all things the most precious, wasting time must be, as Poor Richard says, the greatest 
prodigality; since, as he elsewhere tells us, lost time is never found again; and what we call time enough, 
always proves little enough: Let us then up and be doing, and doing to the purpose; so by diligence shall we 
do more with less perplexity. 






Chess, 18 point only 

Note: Our attempt at compatibility with. St anf ord was only 99” successful. If you use 
a Manif space to indicate an empty white square it will come out narrow due to the 
stupidity of troff. Either include the line 

.cs ch 36 . ^ . v 

to put yourself in constant spacing mode or else use zero instead of space. You 

should aim set the vertical spacing to 18 points. 


.nf 

.ft ch 
.cs ch 38 
.ps 18 
.vs 18 

VOZOZOAOZF 
VZOZOZOOOF 
VOoOZOZOZF 
VZOZOZOZOF 
VOMOZOZOZF 
VjPZOZOZOF 
VOZXZOZOZF 
VZOZOZOZOF 
"WUUUUUUUU3 
•sp 
.ft P 
.ps B 
.cs P 
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■White mates ia three nere*. 









Clarendon, 14 and 18 point roman only. From SAIL (Paul Martin & Andy 
Moorer) 


ABODE PGHIJ KLMNO PQKST UVWXY abode fghij klmno pqrst 
uvwxyx 01234 56789 

" #$!*’<>: \l@ f ;♦/?.>,< 

If time be of all tilings tile most precious, wasting time must be, 
as Poor Richard says, the greatest prodigality; since, as he 
elsewhere tells us, lost time is never found again; and what we 
oa U time enough, always proves little enough! Let us then uc 
and be doing, and doing to the purpose; so by diligence shall we 
do more with less perplexity. 


ABODE FGHIJ KLMNO PQRST UVWXY abcde 
fghij klmno pqrst uvwxyz 01234 56789 

” # $ x * ’ < >: - = \l@'; + /?.>,< 

If time be of all things the most precious, wasting 
time must be, as Poor Richard says, the greatest 
prodigality; since, as he elsewhere tells us, lost 
time is never found again; and what we call time 
enough, always proves little enough! Let us then 
up and be doing, and doing to the purpose; so by 
diligence shall we do more with less perplexity. 








Computer Modern fonee,reman,itcUie,aad bold.(by Dob Knuth) 8,7,8,9,10,11,13 past. (Avertable m cm) 

Note that tho emfonte we intended foe TSX tad don't tee io well wrth trofl Tb* ipaeineit no* propor¬ 
tional by point uie.aod hence only one point rite eta be tuned to be nicely ipeeri We have tuned the 10 paint 
dee, bat the I point looke eamtwh* cramped. 

Sons of the punctuation it strains In tana of the fonta. Knutb eleo ueee a aonitandard notion of ASCII, 
end hence eon dyphe we available only with apodal lymbole each ee \(12* Othere cannot be aeceeeed at ell. 

Knuth’e fonta tanwhal larpr than normal, rinca be intenda the output to be reduced before printing 
Snca troff ha a limitation of 7*4 Inchea width on output,thia !a ad practical. Hence, the oridnal fonta hare 
been relabelled with the paint aiae they we cl are at to without reduction. Soma fonta (6 paint bold, 7 pdnt roman, 
• point italic and bold,9 point bold,and 11 point italic) which would hare othorwiea boon naaiia* were pneraed 
by tbrinkins tha nant lerpr pdnt eiaa of tha aaana atyle. (Tbit p»« a^inat tba idan of matofont.but we m tbi 
tode we havtj 

10 Point Roman 

ABODE FGHU KLMNO PQRST UVWXTZ abcda fghij klmno pqrst uvwxys 01234 
*67S9 ! •* ffBfc ’ () *- \ l ~ ~ @ •> »< S,E,j7H,T I ®,II,,,,A,©,A,¥ ) n,iJ,,,, 

If jjjae be of all things the most precious,wasting time must be,as Poor Richard says,the 
greatest prodigality since,as he elsewhere tells us,lost time is never found a gai n and 
what we call time enough,always proves little enough Let us then up and be doing,and 
doing to the purpose so by diligence shall we do more with less perplexity. 

10 Point Italic 

ABCDE FGHIJ KLMNO PQRST UVWXYZ abcde fghij klmno pqrst uvwsyz 01234 
56789! " # p d & ‘() : — [] | J - ~ —\ w 9 '; + / ?. > , < Z, - -» B, T, <P, II, 

n, 9, l, A, 9, A, !?, O, a, 0, % : f 5 

If time be of all things the most precious, wasting time must be, as Poor Richard says, 
the greatest prodigality; since, as he elsewhere tells us, lost time is never found again; 
and what we call time enough, always proves little enough: Let us then up and be 
doing, and doing to the purpose; to by diligence shall we do more with less perplesity. 

10 Point Bold 

ABODE FGHU KLMNO PQRST ITVWXYZ abode fghij klmno pqrst uvwxys 01234 
56789 ! " # ft % Sc * (): * - == [ ] H - ~ —'\ H © ‘ 1 + / ? • > » < *» % S, T, *, II, 

*, -, a, 0, a, *, n, u j, *•, rr* 

IT be of all thtng e the most precious, wasting time must be, as Poor Richard says, 

the greatest prodigality; since, as he elsewhere tells us, lost time is never found again; 
and what we call timn enough, always proves little enoughs Let us then up and be doing, 
and doing to the purpose; so by diligence shall we do more with less perplexity. 

S Mat Roam Boid^tid JSatfas 

T Point 2? anra, Bold, and ftniu% ~ 

8 Point Roinaa v Bold,Af&d Jtolioa 

9 Point Rom an, Bold,and Italic, 

10 Point Roman,Bold,and Italic, 

11 Point Roman, Bold, and Italic. 

12 Point Roman,Bold,and Italic. 








Countdown (22 point, upper case letters only,) From SAIL (Paul Martin) 


mm fsmj Nifnic pefsst luunvs 

BEEflTlELLl HFSS IE I 1 TESEPJS TE BEEHT 
BBUJfl LLITE EET IT BBfTlEEBSFlTES EV 
EEIflS E 31 I 1 Find ILLEBEBLE 

Cyrillic, 12 point only 


)KU«3 afiae 4>m lutum ope? ysfta 

$ Tjwe fie o$ aju txmhtc rxe moct npesoyc scthht ran jrycr fie ac ocp nap ,a caflc Txe rpearec? 
opoxHrajnrrfi erae ac xe esenepe rejuic yc jioct Time ac Hesep $oyim arara aas xar e ajui ?HMe eaoyrx 
aaaAc opoaec rorrrjje eHoync er yc Ties yn an fie aohht ana aoimr to rxe nypnoce co fifl aa-weae esaju e 
ao Mope htx aecc neponearfl 

lf-*M X-+U Y-»-fc Z-»3 a-*a b->fi d-»a e-*« f-»$ g-»r h-»x i-*« k-»x 1-** m-»w n-*H o-»o 

p-»n r-*p s-»c t-*T u-*y v-»b y-»ft z-*a 


Delegate, roman, italic, and bold, 12 point only 


ABCDE FGHIJ KLMNO PQRST UVWXYZ abede fghij klmno pqrst uvwxyz 01234 S6789 
["IJU 1 ():»•*[] —\ I @ t ;+/?.>, < 

If time be of all things the most precious, wasting time must be, as Poor Richard 
says, the greatest prodigality; since, as he elsewhere tells us, lost time is 
never found again; and what we call time enough, always proves little enough: Let 
us then up and be doing, and doing to the purpose; so by diligence shall we do more 
with less perplexity. 

ABCDE FGB1J KLfflO PQRST UVWXYZ abede fghij klmno pqrst uvwxyz 01234 56789 

!”# SX& 1 (),'•*[7 H — —\ / ® »+/?•>.< 

IJ time be of all things the most precious, misting time must be. as Poor Richard sags, 
the greatest prodigality; since, as he elsewhere tells us. lost time is never found 
again; and what we call time enough, always proves little enough: Let us then up and be 
doing, and doing to the purpose; so by diligence shall we do more with less perplexity. 







ABCEE FGHIJ CLMNO PQEST DVWXY2 abcde fghij klrno pqrst uvwxyz 01234 S6789 
!''#$**’ ():•-*[] H ~ ~ '\ I @ t; ♦ / 7 . >, < 

If tiae be of all things the nost precious, wasting tine must be, as Poor lichard 
says, the greatest prodigality; since, as he elsewhere tells us, lost tine is 
never found again; and what we call tine enough, always proves little enough: Let 
us then up and be doing, and doing to the purpose; so by diligence shall we do nore 
with less perplexity. 


Fix fixed width font, S, 9, 10, 12, 14 point 


S Mint 

*K3C fWU KLTVK3 PQRST UMXY steoea fghij klm P«**t Q1234 S57W 

! * I t ( 1 ().■-• C 1 _J *•♦/?.>•< 

IF tiM M »F nil thir»M tha nit prmciowt* Mating tiaa nw*t be. m Poor Richard ■ arc* the yaataat *rodlMl‘tr» tinea* «a he tlaartia-a 
,.n. l.« t,m .. cil t,~ «•«•*>. .1— r. rM i UttX. l« y. thm y. W m* <o. 

u tn> wmw M kr kiX>««ic« «n,ll «• «k «kr« »ith 


9 point 

ABCOE FGHIJ KU1N0 PCRST UVUXY abed* fghij iclano pqrst uvuxyx 9123* 58799 

! () 1 «-• M j I - — —N | • * | ♦ / P • > • < 

If ties bo of ail thinga tho «o«t prsclous, wasting tlo* aust bo, a* Poor Richard says, tho 
greatest prodigality; tinea, at ha oltauhara tolls us, lost tlaa Is navar found again; and 
H hat wa call tioa enough, always provat llttla anoughi Lot ua than up and ba doing, and doing 
to tho purpose; so by diligence shall ua do aora with lass perplexity. 


10 point 

ABCDE FGHIJ KUTO PQRST UVUXY abode fgh.i j klmno pqrst uvuxyz 01234 5S783 

! " § t X l ’ {) t a - - I I { 1 *">_\| 6‘ 1 + /?.>. < 

If tine be of all things the moat precious, wasting time must be, as Poor Richard 
sags, the greatest prodigality; since, as he elsewhere tells us, lost time is never 
found again; and whet we cell time enough, always proves little enough: Let us then 
up and be doing, and doing to the purpose; eo by diligence she I I we do more with less 
perplexity. 





12 point 


ABCDE FGHIJ KLMNO PQRST UVUXY abode fghij klmno pqrst uvwxyz 01234 
56789 

! " # $ X * ’ ():*--[] (J --\ !©*;-•»/?.>.< 

If time be of all things the most precious, wasting time must be, as 
Poor Richard sags, the p-eatest prodigality; since, as he elseuhere 
tells us, Iost time is never found again; and what we cal I time 
enough, always proves little enough: Let us then up and be doing, and 
doing to the purpose; so by diligence shall we do more with less 
perpI ex ity. 


14 point 

ABCDE FGHIJ KLTNO PQRST UVUXY abode fghij klmno pqrst 
uw*yz 01234 5E78S 

! " # S % & * ():*-«[] 

» < 

If time be of ail things the most precious, uasting time 
must be, as Poor Richard says, the greatest prodigality; 
sinee, as he eIseuhere te11s us, Iost time is never found 
again; and uhat ue call time enough, aluays proves little 
enough; Let us then up and be doing, and doing to the 
purpose; so by diligence shall ue do more uith less 
perp I ex i ty. 






Gacham, roman, bold, italic, 13 point only 

The gacham font is almost indistinguishable from the fix font, 
pointed out that our gacham roman and bold fonts real y are ix. 
eluded anyway for convenience. 


In fact, it has been 
Sigh. They are in- 


ABCDE FGHIJ KLflNO PQRST UVUXYZ abede fghij klmno pqrst uvuxyz 31234 5S789 


! ” # t t & ' () ~ — \ I ® ‘ ;+/?.>, < 

If time be of all things the most precious, wasting time - must be, as Poor Richard 
says, the greateet prodigality; since, as he elsewhere tells us, lost time is never 
found again; and what we call time enough, always proves little enough; Let us then 
up and be doing, and doing to the purpose; so by diligence shalI ue do more with less 

perplexity. 


ABCDE FGHIJ KUHO PQRST UVWXYZ abede fghij klmno pqrst uvwxyz 01234 55739 

If time be of all things the most precious, wasting time must be, as Poor Richard 
says, the greatest prodigality; since, as he elsewhere tells us, lost time Is never 
found again; and what we call time enough, always proves little enough: Let us then 
up and be doing, and doing to the purpose; so by diligence shall we do more with less 
perplexity. 

A prrr FGHIJ jflJtC PQRST UVUXYZ abede fghij klmno pqrst uvwxyz 31234 5S78S 
! " # S X & ’ ():*--[! | | _\ | 9 *;+/?•>, < 

If time be of all things the meet precious, wasting time must be, as Poor Richard 
says, the greatest prodigality; since, as he elsewhere tells us, lost time is never 
found again; and what ue call time enough, always proves little enough; Let us then 
up and be doing, and doing to the purpose; so by diligence shaii ue do more with less 
perplexity. 

Greek, 10 point only 

This font provides an alternative to the Greek characters on the st an da r d special 
font. 


ABCDE 

FGHIJ 

KLMNO 

PQRST 

UVWXYZ 

abede 

fthij 

klmno 

pqrst 

ovTrrgr 

ABXA2 

♦THI* 

KAMNO 

neprr 

T02*Z 


*77** 

rJyw 


rtutrt 


IA npt 3* *4 rytpy* ryt parr rptX^** w ev Ttyy r%(m ever fit er Ho«i» Pixvepi twif* r 9* 7 

rwx* ev f» iVm e iW rtiXr *v X»w rip* w xw> ptnei mymr ttri myorr ** r\pt 1 1 

Ttm« JUrr)U twyy A»r w ryt* vw fit oi leunr f* ryt r»jr or* re 94 lti*7«rx* 

«m !• w»m «•**“» Jew rtawUitff 







The hl9 font includes a subset of the hl9’s graphic charactor set, plus a 
feu logical extensions to allou forms and diagrams to be draun. The charactors 
are the same as the hi9*s graphic interpratation set. 

‘abcdefstuvmnhi kl 

I - + i J L r t 4 A h - + * <• i T 

The charactors are designed to overlap. 


Example of usage for diagrams: 


























Hebrew, 16, 24. and 38 point only 


16 point 

hsbtj? Sirrs? a^c: 1 ! apnre wrr? $5 r n 3®q 2 i s nn* 01234 56789 

! " # «| 3 . ( ) * * [] j ] —\ I @ ? ? . > . < 

cny orarrtn :r «a yncyV^a sn^ay 2 *n rwn a-sjrror'w. :a nac eny 
HTWjasiy '5 ay?:: m^cIbo *ny*rw£j;. bun m :b ui : *1 s*fl ar.*b. : uts yruiu 
*i w?- 1 ?* 

24 point 


823 " :n y 2^; apnea innn a 

Sc^'i: 


an en«n n ;a 2? «; no bb ;a an a n an ;n 
an n ca so. a nxe an jnisass: 2 a xba ra 

n snsc 1 ? . 


36 point (rather ragged) . 







10 point Hershey 


ABCDE FGHIJ KLMNO PQRST UVWXYZ abode fghij klmno pqrst uvwxyz 01234 56789 ' S 

*• *. ’• (• )• [. ]. A ?. • 

\(em - \(bu -* •, \(sq - •, \(ru -* „ \(14 - 3f, \(12 - % \(34 - %, \(fi - 

fl. \(fl ** fl. \(ff ■* ff, \(F1 -* ID., \(F1 -* ffl,-\(de -* *, \(dg -* f, \(fm •*\(ct -* £\(rg -* * 
\(co -» * 

When you flex your Angers in a coffin, it can baffle a giraffe. 

ABCDE FGHIJ KLSJNO PQRST UVWXYZ abode fghij klmno pqrst uvwxyz 01234 56789 ' 

S, Z, Sc, (, ). [, ], \ /, ?, . 

\(em V- \(bu -* •, \(sq -* •, \(ru - . \(14 -»12 -► £\(34 -* ^\(fi -ft, 

\(fl - fl, \(ff - ff, \(F1 - ffl, \(F1 - ffl, \(de - 8 , \(dg t. \(fm - \(ct - *\(rg - «\(eo 

-* C 

When you flex your fingers rn a coffin, it can baffle a giraffe. 

ABCDE FGHIJ KLMNO PQRST UVWXYZ abcde fghij klmno pqrst uvwxyz 01234 56789 !, S, 

Z, *;\ (. ).:, *. [. ]. \ /, ?. . 

\(em —i —* - V* — \(bu -* •. \(sq - «, \(ru -* \(14 -* ]f\( 12 - J$\(34 -• J\(fi - fl, 

\(fl ■* fl, \(ff -* ff, \(Fi ■* ffl, \(F1 -» ffl, \(de -* *, \(dg -* \(fm -»\(ct -* £\(rg -» *\(co 
-8 • 

When you flex your fingers in a coffin, it can baffle a giraffe. 

From special font: ” # = \ I ® ' ' + > < 


Special characters: \(pl -• 4, \(mi -* \(eq -» =. \(** -• • \<sc -* §, \(aa -» ', \(ga -* \ 
\(ul \(si ■+ /, \(*a -* a, \(»b -* ff, \("g -* y, \(*d -»<5. \(*e -* s, \(«z - C. \(*y -* V- 
\(*h -• d. \(*i -► t, \(*k -* k, \(*1 -* X, \(*m -* fj,, \(*n v, \(*c -» £, \(*o -* o, \(*p -* n, 
\(*r ■* p, \(*s -* a, \(ts - <r. \(»t - r. \(*u -» v, \(*f -» <p, \(*x -* *, \(*q - j/. \(*w - », 
\(*A - A, \(-B -* B. \(*G - r, \(*D - A. \(*E - E. \(*Z -* Z. \(*Y - H. \(-H - 0, \(*I - I. 
\(-K - K. \(*L - A. \(*M - M. \(*N - N. \(*C - E. \(-0 - 0, \(*P -* n. \<-R - P. \(*S - 2, 
\(*T - T. \(«U - T, \(-F - #, \(*X - X. \(*Q - \(*W - Q, \( sr - V. \(rn -* “ , \(>= ^ a, 

\( <= "* \( == -* -. \("*s -* at, \(ap •• -, \(!= -» #. \(-> -♦ \(<- -* \(ua -* t, \(da -* 

•i, \(mu -* x, \(di -» 4, \(+- -* ±, \(cu -* u, \(ca -* n, \(sb -» c. \(sp -* 3, \(ib -» c. \(ip -» 
2. \(if ** \(pd -* 3, \(gr -* 7, \(no -* -, \(is -* /, \(pt -* «, \(eq -» =, \(no -• -, \(br -* i, 
\(dd t \(rh - -N(lh -»—, \(bs -© \(or - \, \(ci - O. \(lt -»]. \(lb - L \(rt - f. \(rb - J, 
\(lk -* j. \(rk -* f, \(bv -• |, \(lf -»[, \(rf -* J, \(lc -* f. \(rc -»] 

If time be of all things the most precious, wasting time must be, as Poor Richard says, 
the greatest prodigality; since, as he elsewhere tells us, lost time is never found again: 
and what we call time enough, always proves little enough: Let us then up and be doing, 
and doing to the purpose; so by diligence shall we do more with less perplexity. 


This is an example of a sample in various fonts. 













Hershev font. This is the default font for vtroff. Roman. Italic and Bold in 6. 7. 8. 9. 10 
11. 12, 14. 18. 18. 20. 22. 24. 28. and 38 point. The following examples are j.0 point. 


If time be of all things the most precious, wasting time must be, as Poor Richard says, 
the greatest prodigality; since, as he elsewhere tells us. lost time is never found again; 
and what we call time enough, always proves little enough; Let us then up and be doing, 
anH doing to the purpose; so by diligence shall we do more with less perplexity. 


as Poor Richard says, the greatest prodigality; since, as he elsewhere tells us, lost time 
■ *'■ G r found again; and what we call time enough, always proves little enough. Let 

up and be doing, and doing to the purpose; so by diligence shall we do more 

u nth Lass perplexity . 

If time be of all things the most precious, wasting time must be. as Poor Richard says, 
the greatest prodigality, since, as he elsewhere tells us. lost time is never found 
again: and what we call time enough, always proves little enough: Let us then up and 
be doing, and doing to the purpose; so by diligence shall we do more with less 
perplexity. 


8 point Roman. BoUL ItaHc. 

7 point Roman. Bold, and /toiic. 

8 point Roman. Bold, And Italic. 

9 point Roman, Bold, and Italic. 

10 point Roman, Bold, and Italic . 

11 point Roman. Bold, and Italic. . 

12 point Roman, Bold, and Italic. 

14 point Roman, Bold, and Italic. 

16 point Roman, Bold, and Italic. 

18 point Roman, Bold, and Italic. 

20 point Roman, Bold, and Italic. 

22 point Roman, Bold, and Italic. 

24 point Roman, Bold, and Italic. 

28 point Roman, Bold, and 


Italic. 

36 point Roman, Bold, 
and Italic. 











Meteor, roman, bold, italic, 8, 10, 12 point, no 12 point italic. 

ABODE PGE2J XLMNO PQRST UVWXYZ abode fghij klmno pqrst uvwxyz 01234 56789 
!"#$%&•()**-« '; + /?.>, < 

If time be of all things the most precious, wasting time must be, as Poor Richard says, the 
greatest prodigality? since, as he elsewhere tells us, lost time is never found again? and 
what we call time enough, always proves little enough: Let us then up and be doing, and 
doing to the purpose? so by diligence shall we do more with less perplexity. 

ABODE FGH1J KLMNO PQRST UVWXYZ abode fghij klmno pqrst uvwxyz 01234 56789 

j-~_\/©', + /?.>, < 

If time be of all things the most precious, wasting time must be, as Poor Richard says, 
the greatest prodigality siy :e, as he elsewhere teUs us, lost time is never found 
again; and what we call ume enough, always proves little enough: Let us then up and 
be doing, and doing to the purpose; so by diligence shall we do more with less 
perplexity. 

ABCDE FGHU KLMNO PQRST UVWXYZ abode fghij klmno pqrst uvwxyz 01234 
56789 

! "#$%*• ():»-*□ I®'; +/?.>,< 

If time be of all t hin gs the most precious, wasting time must be, as Poor Richard 
says, the greatest prodigality; since, as he elsewhere tells us, lost i s never 
found again; and what we call time enough, always proves little enough: Let us 
then up and be doing, and doing to the purpose; so by diligence shall we do more 
with less perplexity. 











Micro gramma font, 10 point only 


ABCOE FGHIJ KLMNO PQRST UVWXY a beds fghij kimno pqrat uvwxyz 01234 55783 

! " # S \ ' U *• S|®'; + /?•>!< 

IF time be of all things the most precious, westing time must bs, as Poor Richard says, the 
greatest prodigality; sires, as ha elsewhere tells us, lost time is never found again; and what 
we call time enough, always proves little enough: Let us then up and be doing, and doing to 
the purpose; so by dligancs shall we do more with less perplexity. 


Mona font, 21 point only 


A3BOEE £6^13 S1M2I0 £&£;S£ 11UEX%2 

abc&e fghij hlmno pqrst oouncyz 01231 56789 

I " # * $ S ’ O : - \ j-_\ @ ; ? . 

> , < 

Philadelphia is the most peefesniffian of American 
cities, and thos probably lea&s the rnorlcL 
- 3L Menchen 









Nonie, roman, bold, Italic , 8, 10, 12 point 


ft point 

A8C0E FGWJ KLMNO TOflST UVWXYZ tbcdo fghlj kkrmo pqrst uvwxyz 01234 56789 
!-f ***•<)« ■-.£]{ I 

If time b* of all thhgs tho moat prscloua, wasting tftno must ba, as Poor Richard says, tho graatast prodigality; 
sinco, as ho alsswhora tolls us, lost tlmo Is nowor found again; and what wo call timo anough, always proves little 
onougn; Lot us then up and bo doing, and doing to tho purpose; so by diligence shall wo do more with loss 
perplexity. 


ABODE FGHIJ UMNO POPST UVWXYZ abode fghlj klmno pent uvwxyz 07234 56769 

If tin re bo of *11 thing* tho most proelous, wasting tlmo must ho, as Poor PI char 0 says, tho groatost prodigality, sinco, 
as ho olsowhoro tolls us, lost tlmo Is novor found again, and what wo call tlmo enough, always proves little enough) 
Lot us then up and bo doing, and doing to tho purpose, so by diligence shall wo do more with less perplexity. 


ABODE FGHU KUVNO PQHST UVWXYZ abeda fghlj klmno pqrst uvwxyz 01234 56788 

!"#*%*• ().*-■ »•; + /?.>,< 

If timo bo of ail thbtgs tho most proelous, wasting timo must bo, as Poor Richard says, tho groatost prodigality; 
smeo, as ho olsowhoro tolls us, lost time is novor found again; and what wo call time anough, always proves 
little enough: Lot us thon up and bo doing, and doing to tho purposo; so by diligence shall wo do more with loss 
perplexity. 


10 point 

ABCDE FGHIJ KLMNO PQRST UVWXYZ abode fghlj lclmno pqrst uvwxyz 01234 56789 

I 

!'*#$ X4 • ():*-» nn I®' ;♦/?•>, < 

If time be of all things the most precious, wasting time must be, as Poor Richard says, the 
greatest prodigality; since, as he elsewhere tells us, lost time is never found again; and 
what we call time enough, always proves little enough: Let us then up and be doing, and 
doing to the purpose; so by diligence shall we do more with less perplexity. 


ABCDE FGHU KLMNO PQRST UVWXYZ abode fghlj Klmno pqrst uvwxyz 07 234 56789 

f 0$% *•() t m U~~-\l 9't+ /?.>,< 

If time be of all things the most precious, wasting time must be, as Poor Richard says, the 
greatest prodigality', since, as.he elsewhere tells us, lost time is never found again; and what 
we call time enough, always proves little enough: Let us then up and be doing, and doing to 
the purpose; so by diligence shall we do more with less perplexity. 


ABODE FGHIJ KLMNO PQRST UVWXYZ abode fghlj klmno pqrst uvwxyz 01234 56789 

If time be of ail things the most precious, wasting time must be, as Poor Richard says, 
the greatest prodigality; since, as he aisawhere teils us, lost time is never found again; 
and what we call time enough, always proves little anough: Let us then up and be doing, 
to th^ Purpose; so by diligence shall wa do more with less perplexity. 








12 point 

ABCDE FGHIJ KLMNO PQRST UVWXYZ abode fghij klmno pqrst uvwxyz 01234 
56789 

i — —\|®‘*+/?.>,< 

If time be of all things the most precious, wasting time must be, as Poor 
Richard says, the greatest prodigality; since, as he elsewhere tells us, lost 
time is never found again; and what we call time enough, always proves little 
enough: Let us then up and be doing, and doing to the purpose; so by 
diligence shall we do more with less perplexity. 

ABCDE FGHIJ KLMNO PQRST UVWXYZ abode fghij klmno pqrst uvwxyz 0 7 234 
56739 

- • [ ] 

If time be of all things the most precious, wasting time must be, as Poor 
Richard says , the greatest prodigality • since, as he elsewhere tells us, lost 
time is never found again; and what we call time enough, always proves little 
enough: Let us then up and be doing, and doing to the purpose ,* so by 
diligence shall we do more with less perplexity. 

ABCDE FGHIJ KLMNO PQRST UVWXYZ abcde fghij klmno pqrst uvwxyz 
01234 56789 

!"#$%**():*-■ C 

If time be of all things the most precious, wasting time must be, as Poor 
Richard says, the greatest prodigality; since, as he elsewhere tells us, 
lost time is never found again; and what we call time enough, always 
proves little enough: Let us then up and be doing, and doing to the 
purpose; so by diligence shall we do more with less perplexity. 







English, 8, 14, and IS point only. (IJhis font is called 
"oldenglish '' on line.) 

H powfc 

$<5^3,3SIMl^i© f fl8 JHZ§ ihcb* £gfy$ klmno pcpd ubbzznciHZ34 557B3 
" # f • • l!~~-\o % : . >. < 

I bo* be of all fetnge fee mast prectme, feaefetg fen* must be, as |oor Xifean) sans* fee greefeei pcafega fe n ; e l it e, is Ire 
ekefebere feds us, lost fen* to neber £oura) acpTCinft febut fee cell fen* tnnrayu afeeras probes little ennuxjr.IjJ us feen up anb be 
&o*u^ sxufc iknng to fee puzposeCn bo fokatnct shell fee £a more fetfe less petpkjchx." 


14 jiotrtt 

&-9CTa£ ^<5*113 iap&3r<9 1TTTTXT ***** fghii Mam* 

pqrxt nwxyz 01234 567S8 

" # : (j ^ ~ \ ® 5 • > * < 

It time fa* at all thing* th* most jjrttiou*, wasting tim* must b*. as J^oar 
Richard says, th* greatest prodigality ;xinc*, as h* *ls*wh*r* tells ns. lost 
tim* is n*v*r found againpmd tv-hat tar* call thn* enough, ahvays proves 
Itt!* enough:3Cet us then up and fa* doing, and doing to th* purpose^so by 
dIEgenc* shall or* do mar* tv-iih less perplexity. 


IS paint 

$.33<E33E if<5^33 1^3C3H2yfl? f®EST TFYTfXY? 

abcde fghij klmno pgrst unvxyx QI234 567S3 

"# -O - H ?. >, < 

If time be of all things the most precious, wasting time 
must be, as l^oor Richard sags, the greatest prodigality 
since, as he elsewhere tells us, lost time is nver found 
again and what we call time enough, always proves little 
enough and I think I’m wasting time typing all this stuff 








PIP FONT, IE POINT ONLY, ND LOWER CASE 


ABCDE FGHIJ KLMND PQRST UUWXYZ Q1E34 5E233 


l"# ’ U : - H 


_\ @ 4 ; 7 . > , < 


IT COULD PROBABLY BE SHOWN BY FACTS AND FIGURES THAT THERE IS NO 
DISTINCTLY HATIUE AMERICAN CRIMINAL CLASS EXCEPT CONGRESS. 

- MARK TWAIN 

nutm fnt. It jtiil alj 


am rsHU mao ?aasT uvtjxtz ibti f<ui kiwi hri mm uu 
I •' # J Z *' C 3: « - . U n ^ ~ ® :♦/!.>,< 

IT timt b if til tUi($ til test pittas. nstlif Uu tast it. is ?ar Jlthri sajs. tb (riatist jrttlfiUlT: sits*. as b 
ilsitbn tills its. let tin Is unr fait iftia: at ttat n sail tiw iui(i. tints jrsws Uttli uiajk Lit as tbi a? at ii 
tiiif, at tilif ta tb ?ur?ei: a if Ulijiici sbll n ti in tith liss ;ir?li:itj. 


Script, 18 point only. This font appears to be almost identical to the 
“Coronet” font from SAIL, except that the period and one other glyph 
of Coronet are missing a row, and Coronet is supposed to be 16 point. 

(They are both really the same size.) 


J£C2>£ 3GMJ} jciwno PQPS3 vvwxyz .u. 





_\ @ ; 


. >. < 









£G£EEC£, M PECK? EGtLV, KE EEOSGE ££££ 


) 


(TffPli't? PEEEi GtKGE PISESf EOT9OTE BASS'S SE^Sf 
{" § ' « ESj!-~_\@'«« . >, < 

‘ftcs gEEEEK PEEff OS £32 GXjGGLEGGT EEECEG PEE 
PEEPGGEE i mtmm mm, «? GEES £EG GEVEEtrEGG EP 
GGCEG EEKEgf EEGGEEGEEG. 

cc g E G E E 05 «« 

SIGN, 22 POINT ONLY 


ABODE FGHIJ KLMNO PQRST 
UVWXYZ »C 01234 5 6789 


f "# 


: * - 


H~~-© ;/.>,< 


THIS FONT WAS INVENTED BY A 
DRAFTSMAN WHO HAD LOST HIS 
FRENCH CURVE. >S0 IT GOES « 


LOWER CASE L IS », LOWER CASE 
R IS 










Stare hershey font This font is identical to the hershey font except that the point sizes are one point 
smaller, and the width tables are those used for the real typesetter. Hence, this font is useful when 
previewing documents that are to be sent to a typesetter to make sure the spacing, paging, and so on is 
right. There are Roman. Italic and Bold in 0, 9, 10, 11, 12, 14, and 16 point The following examples 
are 1C point 

ABCDE FGHIJ KLM NO PQRST UV"ff XYZ abode fghij klmno pqrst uvwxyz 01234 56789 

!"#S %&'():*- = [ ] H ~ \ I ® ‘ /?•>.< 

If time be of all thing* the most precious, westing time must be, as Poor Richard says, the greatest 
prodigality; dnce, as he elsewhere tells us, lost time is never found again; and what we call time • 
enough, always proves little enough; Let us then up and be doing, and doing to the purpose; so by 
diligence *hai1 we do more with less perplexity. 


ABCDE FGHIJ KLMNO PQRST UVW XYZ abode g kbrwo pqrst wjwsys 01234 56789 
!"# SX &•():•• s [ ] H - ~ _\ |9 ‘ ; + /?•>■.< 

IfUjTu be of ail bungs the most p rec iou s, wasting torn must be, as Poor Richard says, he greatest prodigality; 
save, as he etseuhere t ells us, lost t&re is never fiimd again and uhat we caU, tine enough, atuatfi proves 
Bttts enough: Let to then tgj and be doing, and doing to the propose; so by diligence shall we do more uxth less 
perpt ady. 


ABCDE FGHIJ KLHNO PQRST UVTTXYZ abode fghij klmno pqrst uvwxyz 01234 56789 

= /?•>.< 

If be of all thing* the most precious, wasting time most be. as Poor Richard says, the greatest 
prodigality; ««"«*■- , as he elsewhere tgjl* ns, lest time is neves- found again; and what we call time 
enough, always pro v es little enough; Let us then up and be doin g, and doing to the purpose; so by 
<Sligenoe *h«H we do more with less perplexity. 


8 point Roman. Bold sod Italic. 

9 point Roman, Bold end /tats. 

10 point Roman. Bald and Rate. 

11 point Roman, Bold and Italic. 

12 point Roman, Bold, and Untie. 

14 point R oman, B old, and Hotie. 

16 point Roman, Bold, and Italic. 







Times fonts, roman, italic , and bold 10 point only. 

These fonts showed up in a directory labelled ’timesroman" 1 along with three other fonts which turned out 
to be nonie, meteor, and news gothic. They are probably not really times fonts, but seem to be pretty close. 
Notice the top of the "2” for a clear difference from a real Times Roman font. 

It is our desire to have a real, digitized Torsion of the times fonts from the phototypesetter. We eventually 
plan to do this. At that point, the times font will probably replace the hershey font as the default. Such a 
Times font is already available from Johns Hopkins University for a fee, but we couldn’t redistribute it, so 
we plan do digitize them ourselves. 


10 Point 

ABCDE FGHLJ KLMNO PQR5T UVWXYZ abode fgfaij klmno pqrst uvwxyz 01234 56789 

’i -♦ -i #, □,, \ H, h, fi, fi, ff, ffi, ffi, ti \ 

ABCDE FCHIJ KLMNO PQRST UVWXYZ abed e fghij klmno pqrst uvwxyz 01234 56789 

/ ,# # 11 * • f;: * - - C ] H • ^ I ®' < 

\ •> \ t.tr* 

ABCDE FGHU KLMNO PQRST UVWXYZ abode fghij klmno p*rst uvwxyx 01234 56789 

’i -f -i ■,, S H, H, fi, fi, % ffi, ffl, tr'j tf* 
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